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“te Introduction 


The supervisory system MOLD is designed to enable a 
number of systems-programmers (perhaps a dozen) to debug 
their programs simultaneously. Each user will have the 
freedom of hands-on debugging, and the convenience of 
teletype control from. remote locations. 


MOLD uses ‘a GE , 625/635, sonbicusatien: with communication 
controlled by a local Datanet-30. Input from teletypes is 
either acuee to this D-30, ox chanelled via a remote 


To connect to MOLD, one calls ue D=30 from a eciekynes 
When the phone is answered, an identification may be: obtained 
by a WRU (control-E). Communication beyond this point is by. 
a one-line-at-a-time command system (except when building | 
files, see EDIT), waiting for system response. before the next. 
command. Each of these must be addressed to one of the four 
operating systems:  GMAP (for compiling), LOADER (for 
obtaining a core~image of a compiled program), EDIT (for filer 
manipulation), and DDT (for aruda) These are explained 
in detail below. _ 


t 


The eo iiowing information is generally ueeears One must 
start by typing — ° . : 


“RUN XXXX > 


where XXXX is the name of one of the four systems. GMAP and. 
LOADER accept only a single command. (To reuse them, a new’ 
RUN is needed.) However, EDIT and DDT permit conver sations, 
hence they are available to the user until he types EXIT. 


Pile names and passwords (which, are optional). have up to 
eight characters (letters and digits only), and they are 
recorded pene uae eees filled with. blanks. 


Certain teletype keys play special roles: Back-arrow 
or control-H erases a character, control-X deletes a line, 
and the break key may be used to abort a job (e.g. stop output). 
In the initial phase of the system it would be a good idea for 
the user to push the break key before typing RUN for the first 
time, to wipe out any incomplete jobs associated with his tele=- 
type... | : 


~When finished, the user should type TERMIN 


22 GMAP 


After the user has typed RUN GMAP, the system will 
return GMAP HERE when ready. The user will then type an . 
input line of the ORT eWang. forms | 


- SOURCEF ILE G password); LISTFILE aC password); BINFILE (,p)7 
ERRF ILE (-P) (cr) se a ae | | 


LISTFILE, BINFILE, and ERRFILE ‘stand for the three output | 
files = listing file, binary deck file, and error file. If. 
these are not to be outputted, nothing should be’ a 
in er place in the anu line. Thus 


SOURCE 3 3 ;ERRFILE, Seas 


would output only the error file. Files used in GMAP must 
have been previously saved by the user through EDIT. The 
error file will contain the line numbers of the incorrect | 
“cards" with the error flags, the cross-reference table, and 
the undefined symbol list. To use GMAP again after the line 
has been inputted, the user must again type RUN GMAP. The 
system automatically exits from GMAP after each operation. 


GMAP assumes that the file to be compiled has line 
numbers. These may be supplied by means of EDIT, 
‘LOADER ° 


_ The purpose of the LOADER is to convert a card image file 
to a core image file. . After typing 


RUN LOADER 


the system will return oe 
LOADER HERE. YOUR MOVE. 


Then, as in GMAP, .the, user inputs one line 

FILEOUT3 SYMFILE? MAPF ILE 3 FILE1L;--3 FPILEn 

where SYMFILE and MAPFILE are optional and may be omitted by 
two semi~colons in a row as in GMAP. SYMFILE stands for symbol 


table and MAPFILE for memory map. Thus the LOADER takes 7 
FPILE1,--, FILEn and converts them to binary images and puts 


them into a single FILEOUT. The output then is the core 

image, FILEOUT, and the optional reshuffled symbol table 

and memory map. Passwords may be used, as in GMAP, and all 

files must have been previously saved. The system auto- 

matically exits from LOADER after the ‘completion of the job. 

_GMAP and LOADER also re SAVE and CLOSE the. files 
used..in..theix operations’. an oe 2, RO BSBREE 


0 


EDIT 


‘The object of EDIT is £0 maintain and make changes in 
the source Eides.- After the typing of' 


RUN ED it 
the system will return _ 
EDIT HERE 


when EDIT has been loaded. aes user can then give any one 
of several commands. The system will remain in EDIT until 
the user types EXIT as a command. EXIT automatically 
releases all active files. | . 


Oniy one file with a a given file name can be active at 
once. Thus, two files with identical names but different 
passwords cannot be active at the same time. Passwords, if 
used, are needed only with the commands o1D, SAVE, and UNSAVE. 
The EDIT commands and their descriptions follow. Several 
files can be active at once, So each command requires a file 
name. 


NEW FILENAME]; FN2; ..c- 
creates a new scratch file for eich name given. 


OLD FILENAME, eee: coco | 
recalls previously used and saved files, needs the 
Par sword: used when last saved. 


UNSAVE FILENAME, password; coocce . a 
destroys permanent files. Files must be inactive at, 
the time. | 


RENAME OLDNAME? NEWNAME; OLD? NEW; wooo - ) 
renames OLD file with NEWNAME, inactivates OLD file. 


RELEASE FILENAME; FN; oo«. | 
inactivates as many files as you name. Passwords not 
necessary. | ; 


SCRATCH. FILENAME 3 ooo° 
destroys temporary copies of files named, name remains 
available for use. | . 


SAVE FILENAME » password; eeo00 
catalogs files, password needed to get file back. It: 
is not possible to SAVE a file if there is already a’ 
filename with that password SAVED. It must first be 
UNSAVED, if you wish to replace it. | 


BUILD FILENAME 


Normally the user is allowed to type only one line at 
a time, and must then wait for the system to respond. This 
‘is clearly inconvenient for building files. The command 
BUILD, issued to EDIT, allows the user to type in a large 
number of lines, without waiting for system response. ‘These 
lines are added to the file he is building. Clearly only 
one file can be built at a time, hence BUILD has a single 
. filename as argument. When the building operation is 
completed, the user types a blank line (i.e. hits the carriage 
return an extra time). The system will respond READY. Then. 
he can issue a new command to EDIT. 


there is a limit of 2000 characters in one BUILD. 
.Since this represents over 3 minutes of typing, at maximum . 
teletype speed, this is not a serious restriction. In any 
case, though a vacuous carriage return must occur no later 
than the 2000th character, the user may then type BUILD, 
and continue building his file. 


To make changes. in a ‘file the following peace ae must be 
usedo 


OLD A 
BUILD A 
RENAME 3:B 
UNSAVE A 
RENAME B7A 
| SAVE A 


This procudure will be simplified Tater. 


‘The following EDIT commands are similiar to the EDIT 
commands in the present Time~Sharing eiores 


APPEND FILE}M ; FILED; 200. 
All files are added to the end of the previous file 
and ae resulting file is called Ens: | 7 


SORT scan 7 Ta, a 
| nly one file name is. given.: The line numbers are ~~ 
ned and only the last one appears in the file. ‘Thus 
“if-there are two lines with number 340, only the last 
-one will appear in the resulting file. A file can. 
contain no more than 4094 lines, and if no line number 
as: given it will be considered as line 0. . 


SEQUENCE FILE; A,B , a 

Puts line numbers in the file. The original file need © 
rot have. line numbers. ‘The first line number will be 
A with the increment equal to B.: If A and B are not 
given, A will be.100 ar an Bwill be 10. The only legal 
Line numbers are Ose 2 ale a Ta Oh ae 


LIST FILE; A,B, C-D, or : as 
- will List file with lines in ne order given. If no ~ 

parameters are given, a forward list will be given. In 

a select list, the lines must be in the first 4094 lines 

of the file. There is no restriction on a non-select _ 
List. : 


DELETE and EXTRACT : | 
| are the same as in the present EDIT system. The format . 
is the same as LIST. The parameters must be given in 
increasing order. : 4s 


DDT 


DDT, like EDIT, can do several operations and depends 
on the instructions given to it. Like EDIT, you must type 
"EXIT" as a command to get out of DDT. The purpose of DDT 
is three-fold. — c 


6. 
1) «Trace a program by printing out the contents of 


selected registers or memory locations, at selected 
times during a RUN. of the PEQgrathe 


2) Patch any desired esereeti snare: changes. into any | 
location in’ the assembled program. This can be © 
done without reassembling the program and can be 
written in the source pone of the program. 


3) Embed ipuaaieoiwea’ in the program. The message 
"BREAKPOINT AT LOCATION XXXXX"-is then printed out. 
The user may then make changes, have memory or 
Begteeere printed out, or ney simply resume execution. 


In DDT, the format of a number” specifies its type. Thus, 
64 octal, 64. is decimal, and 64.0 is £ floating point. 


| To allow more than one DDT’ command on.a teletype line, 
an is used as a substitute for c.r. Thus. several commands’ 
Separated by ¥'s may be typed on a , dine. — A description of 
‘the DDT commands follows. | ; 
LOAD ene: Password; SYMFILE, ‘Password j= 

A file and its symbol table file created by the ‘loader 

are loaded into Memory « The loader must always be used 
first to create a core image file of.all the programs you. 
want to run under DDT. 


FORMAT Mode 2 
All output will be given in that output mode, with one | 
exception. If a command is preceded by an output mode 
symbol, the output for that single command will be in 
the specified mode. The available output modes are: 


SYM Symbolic Mode. The contents of the location are 
printed as a mnemonic operation code followed by a 
symbolic address and as address modification field. 
DEC Decimal Mode. The contents of the location are 
printed as a fixed-point decimal constant. : 


OCT Octal Mode. The contents of the location are 
printed as a fixed-point octal constant. 


FLO Floating point Mode. ‘The contents of the location 
are printed as a floating point constant. | 


Ts 
BCD Binary Coded Decimal Mode.. The contents’ of the. 


location are printed: as 6 alpha-numeric characters of : 
6 bits each. 


ASC ASCII Mode. The contents of the location are . 
printed as 4 epehaceunenic characters of 9 bits each. 


HAL Half-word Mode. The contents of the oeaeion are _ 
pa as two symbolic address expressions (18° bits each). 


TAL tally Mode : The sonednte Ge the. iocation are 
printed as a abode address, a tally count; and 6 7 
modification bits which will be printed as 2 octal Re cla 


| DUMP Address List _ 7 
| Each element of the address list is either a single 
address or a pair of address expressions ‘separated by 

a comma. ‘The elements of the address list are separated 
by semi-colons. The contents of these locations are 
Beenie out. | 7 


PATCH Single daaveee Expression; List of Word Expressions . °F 
The word-expressions, which are separated from each 
other by .semi-colons, replace the contents of sequential 
memory locations at the address given in the first 
argument. . 


‘BREAK A(i),2(1),L(1)u(1); A(2)peeeee- us 

A single BREAK command can embed several breakpoints. 
Each breakpoint has from 1 to 4 arguments. Different 

breakpoints are separated by semi~colons. . 

The first argument, A(N), is the address at which the | 

the breakpoint. is inserted. If A(N) is the only argument 

supplied, the program halts, the breakpoint message is 
printed out, and further instructions are awaited. The. 
instruction in the location where the breakpoint is 
inserted is not executed before the BREAK takes: place. 

If I(N) is also supplied, the breakpoint will be ignored 
X(N) times. If it is not-specified, it will automatically 
be O. | | | 

If L(N) is supplied also, the contents of location L(N) 

will be printed out along with the breakpoint message. 

If U(N) is also supplkd, L(N) specifies the lower bound © 

of the block ‘of memory to be ponte out. U(N) is the 

upper boynd. _ 


8. 


Breakpoints cannot be placed in. the following locations: 
1) Program modified locations. 
_2) Instructions to be executed by a XEC or XED. 


UNBREAK . Address List — Sf 
: vi 
The address list may be omitted or may contain any 
number of single addresses separated by semi~colons.. 
The breakpoints at these addresses are removed. If no - 


‘list is given all the breakpoints are removed. . 


CONTINUE X(N) if | Bate gts 8 
Execution of program resumes. The next instruction © 
executed is the instruction at the breakpoint location. 
_ Ef I(N) is supplied, it replaces the I(N) for this 
breakpoint. | 


| oF ee 5h. 
TRANSFER Single Address Expression ei 


Execution of program commences, or resumes at Location 
given. This must be given to start a program. After _ 
a breakpoint, control can be transferr ced to ‘any location 
desired. es 


REGISTER - Optional List of Register Identifiers . 73 


“he argument list, if supplied, is a list of register 
identifiers separated by semi-colons. The contents 

‘of these registers will be printed out. If no arguments 
are given, all registers will be printed out. The. 
index registers are specified by a number only, ,not XN.. 


‘ . we 
ALTER Register Identifier, Expression;... = 
The contents of each register specified are replaced: 
by the corresponding expression. 


_ SAVE Program Name 4tF 

| The program, or programs, currently loaded are saved 
under the name supplied. AIlL breakpoints, patches, 
ect, are: Pees as they stand. 


—MZED 
USER MANUAL. . 
SUPPLEMENT NO. 2 -- OCT. 8,1966 © 


MOLD. HAS: NOW RUN SUCCESSFULLY IN BSTH ROME AND PHESNIX. IN 
FACT, BILL ADANS REPORTED HE G@T 4 DAYS WORK D@NE IN SEVERAL 
HOURS USING M3LD, HE SAYS T@ COUNT HIM AS AN ENTHUSIASTIC 
MOLDY SUPP3RTER. | | 


3 SUPPLEMENT CONTAINS S3ME WARNINGS CONCERNING CaMMANDS: 


WHICH WERE EXPLAINED IN PREVIZUS MALDY C@MMUNICATI@NS. ALS2@. 
SEVESAL NEw COMMANDS HAVE BEEN. ADDED T9 MOLD SYSTEMS. THESE 
NEW C9MMANDS ARE EXPLAINED BELOW, 


-M@LD EDIT PACKAGE 


BUILD F 


WARNING: A MAXIMUM OF 1024 CHARACTERS CAN BE APPENDED Ta” 
FILE # WITH SNE-USE 3F THE BUILD COMMAND, IF YU NEED 


TZ APPEND f"ZRE THAN 1024 CHARACTERS YSU MUST EXIT BUILD | 


MODE PRIOR T3 THE TYPING @F- THE {024TH CHARACTER AND 
~ THEN ISSUE ANOTHER BUILD COMMAND. | fe 


APPEND Fl:F2: 2... 3FN 


NOTE: IN AN APPEND COMMAND THE SECSND OCCURRENCE @F THE. 
FIRST FILE. Fl REFERS T3.THE FILE AS MSDIFIED BY THE 
APPEND C3MNAND UP T® THAT POINT, FOR EXAMPLE, THE 
COMMAND ~~ —— ms 
‘APPEND A,B,C,A 


RESU ULTS IN THE FSLLSWING SEQUENCE @F OPERATIONS 

1 FILE B IS APPENDED TZ FILE A GIVING A+3 

2 FILE C IS APPENDED T@ FILE A+tS GIVING AtB+C 

3 FILE A+t35+C IS APPENDED T9 At5+C GIVING A+tB+C+A+B+C 
AS THE FINAL RESULT. THE RESULTANT FILE HAS THE NAME A 
AND REPLACES THE PREVIZUS CONTENTS OF A. 


MILD DEBUGGING PACKAGE 


EXTEND E# 


THE EXTEND CUMMAND IS USED FOR SETTING THE MEMORY BOUND 
OF. THE PROGRAM BEING DEBUGGED. EXTEND TAKES ONE 
ARGUMENT WHICH = IS AN EXPRESSION REPRESENTING. THE FIRST 
C3RE LAICATIZN NOT REFERENCED BY THE PROGRAM. THE 
‘DEBUGGING SYSTEM WILL REJECT ANY EXECUTIVE COMMAND T@ 
THE MOLD FILE SYSTEM THAT REFERENCES MEMORY NOT IN THE 
PROGRAM'S BOUND. “ALSO THE USER. MAY NOT PATCH OR DUMP 
_ MEMORY NOT IN HIS PROGRAM'S BOUND. THE MEMORY BAUND 15 
ALS CHANGED BY. THE L3AD COMMAND TO POINT T@ THE FIRST 
LOCATION NOT USED BY THE CORE IMAGE PROGRAM. THE SAVE 
‘COMMAND ALSS MAKES USE OF THE MEMORY BOUND IN THAT IT 
ONLY SAVES THAT SECTION OF .CORE WITHIN THE USER'S 
BOUNDS. | ss 


ZERO MI,NI,E1sM2,N2,E23ee03Md,NJ,Ed# 


ZERS@ IS USED FOR SETTING A BLOCK OF MEMZRY TO A 
CONSTANT. WHAT ZERO DOES IS SET THE BLOCK WHOSE LOWER 
ADDRESS IS M AND WHOSE UPPER ADDRES IS N TOE, IF £15 
MISSING THEN THE BLOCK BETWEEN M AND-N IS SET. TO ZERD. 
IF BOTH N AND E ARE MISSING THEN JUST THE SINGLE 
LOCATIGN M IS SET TS ZERD. | 


MERGE FlsF2; ... $FN 


THIS C@MMAND MERGES FILES F2 THROUGH FN INTO FILE Fl. 
THE KEYS USED IN THE SORT ARE 1) THE @RDER IN WHICH THE. 
FILE NAME APPEARED IN THE MERGE COMMAND, AND 2). THE LINE 
NUMBER OF THE LINE IN THE FILE, S®@ A LINE (L,F) , WHERE 
L IS THE LINE NUMBER AND F IS THE FILE NAME, WILL 
‘PRECEDE A LINE (M,A) IF L<M OR IF .L=M AND .F OCCURRED © 
BEFORE A IN THE MERGE COMMAND. | 


WEAVE Fle F23 «ee 3 FN 


THIS COMMAND IS EQUIVALENT T@ THE EXECUTION OF THE 
FOLLOWING TWS COMMANDS: 

1 APPEND FIsF23 wee 3FN 
2 SORT Fl {- 


“DRESS MODEF 


ADDRESS IS USED T3 SET THE ADDRESS MODE. IT- TAKES. ONE 
ARGUMENT WHICH MUST BE ONE OF: | _ eee 


1) QCTAL ADDRESSESCPRINT AS 6 DIGIT ZCTAL NUMBERS) — 
2) DECIMAL ADDRESSES(PRINT AS DECIMAL NUMBERS). 
3) SYMS9LIC ADDRESSES(PRINT AS SYM3BSL + A CONSTANT) 


SYMB33LIC, WHICH ISN'T IMPLEMENTED YET, WILL BE NORMAL. 


MIDe. HOWEVER, UNTIL SYMBZLIC MODE IS WORKING, 6CTAL 
MODE WILL Bc THE NORMAL MADE, en | —_—— | 


OPTION OPT1;OPT23...39PTud 


@PTIZN IS USED T9 SET THE DESUGGER"’S METH2D OF HANDLING | 
FAULTS, THE FOLLOWING ZPTIONS ARE AVAILABLE - . 7 


MEMORY sNOMEMORY 
MME: NOMME 
FAULT; NSFAULT 
TIMER SNOTIMER 
COMMAND 3 NZCIMMA ND 
DERAIL: NODERAIL 
LOCKUP : NSLZCKUP ' 
CONNECT; NOCONNECT 
PARITY: NOPARITY 
ZERDs NOZERD 
ONC: NZONC 
STARTUP sNOSTARTUP 
OVERFLOW: NSIVERFLOW 
DIVIDE; N9DIVIDE 
EXECUTE: NSEXECUTE 
MILD:NSMSLD 


THE NQ OPTION ASKS 
OPTION BE TURNED GFF, 


MEMORY FAULTS RETURNED. 


MME'S AND FILE CALLS, 


FAULT TAG FAULTS RETURNED. 
TIMER RUNOUT FAULTS RETURNED. 
CZMMAND FAULTS RETURNED. 


DERAIL FAULTS RETURNED, 


LOCKUP FAULTS RETURNED, 

CONNECT FAULTS RETURNED. 
PARITY FAULTS RETURNED, 

ZER@ OP FAULTS RETURNED. 
BP NOT.COMP. FAULTS RETURNED. 
STARTUP FAULTS RETURNED. : 
OVERFLOW FAULTS RETURNED, 
DIVIDE CHECK FAULTS RETURNED. 
EXECUTE FAULTS RETURNED. 
MME'S GIVEN TO THE MOLD EXEC. 


THE SPECIAL FAULT HANDLING 


NORMAL MZDE IS ALL @SPTIONS OFF, 


SHJJULO ALL @rPTIONS BE TURNED ON THEN ANY PREGRAM RUN 


UNDER THE DEBUGGING 


SYSTEM WILL RECEIVE FAULTS AND 


HANDLE FILE CALLS EXACTLY AS IF UNDER THE MOLD EXECUTIVE 
DINECTLY. THE @ONLY FILE CALL THAT IS NOT SIMULATED I5 


' THE "“GETCAT"” CALL. FAULTS 
MANNER AS THE MOLD EXECUTIVE. 


ARE RETURNED IN THE SAME 


SILE. CALES=== 


THE DESUGGING PACKAGE ALS@ ALLOWS THE USER T@ TYPE IN AS © 
COMMANDS FILE CALLS TQ THE MOLD EXECUTIVE, THESE CALLS 

WILL BE EXECUTED EXACTLY AS IF THE USER*S PR@OGRAM MADE 
THE CALL ITSELF. THE AVAILABLE COMMANDS ARE + 


READ FrAI,MI,NISFR2,M2,N2 .ec- 
APPEND Fri ML NLS FR2, 2, \ ee 
“REWIND FRI sFR2 ... - 

SCRATCH © arate hE: wees 

CLOSE FRI;FR2 eee 

DESTABY FRL,NAME,PSWs... . 
CATLOG FRL,FrR2, NAME »PSW5 wee 
OPEN FRI, NAME, PSM oe OR OPEN 3s Sas 


TN THOSE caitia NDS REQUIRING A PASSWORD, IF THE PASSWORD 

JIS MISSING THEN NZ PASSWA@RD (A PASSWORD OF ZERO) I5 
ASSUMED. IF THE FIRST CHARACTER OF THE NAME @R PASSWORD. 
IS A SLASH, THEN THE REMAINING CHARACTERS @F THE NAME QR. 
PASSWIRD ARE ASSUMED TZ BE SCTAL DIGITS WHSSE VALUE WILL 
BE. USED IN -PLACE OF THE -ASCII NAME OR PASSWORD, A. 
SPECIAL CASE IS THE SPEN COMMAND. IF ITS ARGUMENTS ARE 
NULL THEN IT OPENS A SCRATCH FILE. STHERWISE IT @PENS 
THE FILE WITH SPECIFIED. NAME AND PASSW2RD FRYM THE 
CATLOG -SPeCIFIED IN FILE REFERENCE NUMBER, ON THE 
INITIAL M2LD SYSTEM THERE IS @NLY ONE CATAL@G AND ITS 
FILE REFERENCE NUMBER SHZULD BE 1, | 
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5 SAGHETIC TAPE 
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8 REMOTE CAaXSOLES 
9 TYPEWRITER: 
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‘10 CARD READER 
SECONDARY STORAGE IS COMPSSED SF TWO CLASS 
CLASS 1 WORDS ASSIGNED FGR USE BY A. FILE 
CLASS @ WGRDS WHICH ARE AVAILABLE FSR AS 
. FREE STORAGE. 
i i a | , 

A FILE IS ANY SOURCE Gr MU CH MAY BEO 
STORAGE ASSIGNED BY THE EXECUTIVE FaR US 
TYPES WF FILES : 
CATALGSG "TLE ; 

A CATALSG FILE ‘IS A: FILE WHICH CONSISTS 
ENTRIES WHICH CATALSG STHER FILES. THAT IS 
NAMES A FILE SF THE SYSTEM, -CATALSGS HAVE 
WHICH IS DETERMINED BY THE EXECUTIVE. ALS 
MODIFY CATALSG ENTRIES BY CALLING. UPGN EXE 

CONVERT THE PARAMETERS @F THE CALL TS THE 
LGGICAL C@NTENTS GF A CATALSG ENTRY 

Arte oD plik 

ACCESS L&CKS(READ, APPEND, WRITE, EXECUTE,R 

PASSHORD 9? HAME LOF TRAP FILE . 

STATISTICAL INFGRMATIGN (DATE. @F CREATIS 

NUMBER GF DATA S9RDS IN FILE |: 

BEGINNING AND EMDING DEVICE ADDRESS, PLU 

TYPE GF FILE (CATALSG GR DATA FILE) | 

ATTACHMENT LEVEL(CSUNT GF USERS: ATTACHE! 

APPEND FLAG C@NLY GNE @F THE USERS ATTAC 
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AD 
ACKS 


ERS AND TRA 


UNATTACHED FILES 


EACH FILE HAS AN ATTACHMENT LEVEL 
GONE EACH TIME THE FILE IS gp ae 
TIME THE FILE IS CLSSED, THUS TH 
COUNTS THE NUMBER G@F FILE RE TERE il 
OTHE PLES | i 


PLE 
SCHED -FILE 
©} THUS 


UNATTACH 
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LEVEL OF 
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AND FGR REDUNDANCY CHECKING, 
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MAT AND CONTENT 
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WHICH INCREMENTE 
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E ATTACHMENT LEVEL 
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ATTACHED FILE ee: 
AN ATTACHED FILE IS ANY FILE WITH AN ATTACHMENT Leven 
WHICH IS GREATER THAN O. AN ATTACHED FILE ~ HAS Bi oe | 
FOLLSWVING PR&PERTIESs ; : 
' 2 IT IS IN USE SY ANE GR MORE JOBS;.. . ee 
@ FSR EACH JSB WHICH IS USING THE FILE. THE EXRCUTIVE SYSTEM 
HAS SUPPLIED A ae ean NUMBER" WHICH MUST RE USED 
WHEM REFERENCING THE ILE, ¢THE FILE REFERENCE NUMBER. IS 
“RETURNED AFTER & SUCC FSSFUL @PEM.) 
% FILE MAY BE UNCATAL@GUED coos AY USCATALGGUED FILE Is 
ONLY TEMPGRARY IN THE SENSE THAT IF IT IS CLOSED 
BEFGRE BEING CATALSGUED ITS CONTENTS ARE LOST. 
GULY. ATTACHED FILES MAY BE READ, APPENDED T@, @R USED AS A CATALOG. ° 
AN ATTACHED FILE MAY BE I8 @NE SF THE FSLLOWING THREE 
SUBSTATES:s a a ae | 
lt NEUTRAL ~ THAT STATE WHICH EXISTS AFTER A ‘SUCCESSFUL 
SPEN BUT -PRIGR T& THE‘ FIRST READ GR-APPEND REQUEST. 
2 APPENDABLE  ENTEREI GN EACH APPEND REQUEST. 
3 READABLE ENTERED @N EACH READ, SKIP GR REWIND 
| REQUEST. - | 
AG , <* 
CATALSGUED VS UNCATALOGUED FILES - 
‘CATALIGUED FILE | 
ANY FILE WHICH IS REFERENCED BY AN ENTRY IM A CATALSG. 
UNCATALSGUED FILE | 
ANY FILE WHICH KAS BEEN GIVEN A FILE REFERENCE HUMBE) 
CIT IS IM USE). BUT HAS NGT YET BEEN CATALSGUED. 


HOLD FP 

EACH COMMAND IS IN THE FORM OF A SYST BN He ACR « THE HACRO | 
PROTOTYPE WILL BE SUPPLIED TO EACH SYSTEM PREGRAHSER. EVENTUALLY 
THES SS WILL BE A PART OF GOLD °S: SYSTEN LISRARY > 


UHEN A FI 
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COMMAND IS ISSUE t9 THE EXECUTIVE THE USER HUST 

) ALL REGISTERS (A,Qj2 AND INDEX REGISTERS 

i BEEN pEstRavEs, wif oe 

(2) THE FUNCTION REQUISIED BY t 
BEEN CARRIED GUT _ 

(3) INDEX REGISTER 0. ULLL BE ZERG 
ACCEPTED AND NON ZERO IF THE 

Cay SENTACTICALLY INCORRECT, AND 

(4) THAT EACH CGHHAND HUST SPECI! 
UHICH JILL BE INVGXED WHEN .T 
HAS BEEN CARRIED 79 COMPLETI 

| AN ERROR GF SGHE SORT. 
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qf PROGRAM TIN GB I OY eo 
EXECUTIGN OF THE FILE OPERATION, WHEN THE EXECUTIVE HAS 
GOMPLETED THE TASK (OR TASKS) REQUESTED "BY THE CGMMAND THE 
PRIGRAN WILL BE INTERUPTED AND ee WILL BE TRANSFERRED 
1G THE TRAP PROGRAM. THERE HUS’ A SEPARATE TRAP PROGRAT 
FOR EACH FILE CSRHAND SUTSTANDING. If THE PREGRAMNER IS 
CLEVER HE WELL SEE THAT HE CGULD USE THE SAME TRAP RGUTINE 
if HE PRGVIDES THE EXECUTIVE WITH 4 UGRDS YHICH PURPORT TH BE 
THE FIRST FOUR YORDS GF A TRAP PROGRAR THE BKECUTIVE ASSUMES 
THAT THE PIRST POUR UGRDS GF THE TRAP PROGRAM CAN BE USED FGR 
GR ALUAYS CONTAIN THE POLLGUINGs 
WORD | STATUS RETURN WERD 1 
| — SRULCEE, 35) GONTAINS THE TYPE OF RETURN 
WORD 2 ' STATUS RETURE  WERD 2 | 
MGRD SO . THE EXECUTIVeG STGRES THE INTERUPT LECATIGN 
PLUS 1 AND THE INDICATGRS IN THIS LOCATIGCN. 
THE EXECUTIVE DZES THE TaUT ve LLENT OF A 
"StC) UGRD3S°. THE TRAP eee RAM MUST 
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EXIT BY EXECUTING "RE : 

“WGRD 4 FIRST LOCATION oF THE TRAP PROGRAN 

s THE GRDER IN UHICH THE PROGRAM EXECUTES Fi 
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ENABLED. DGN'T GRY 20 DISCERN ORDER WHER 1B NGNE 
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PILE REFERENCE RUMBER ALL SUBSEQUENT COEAANDS WHICH AFFECT. 
THES FILE HUST SUPPLY. THE FILE REFERENCE NUMBER AS & PART GF 
THE COHMAND. THUS THE FILE REFERENCE NUMBER £5 THE NAME UNICH 
THE EXECUTIVE AND THE PRGGRAH USE TO DESCRIBE THE FILS WHILE 
IT £5 ATTACHED ae THE PROGRAN 
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OPEN .7,FR,NANE,PASSUORD, (ACCESS LIST) 

T LOCATION GF TRAP rRoeral ae ee 

FR. FILE REFERENCE NUMBER GF CATALOG FILE 19 SEARCH - 

NAME §° NANE OF THE FILE | a 4 

PASSUGRD HUST BE BAUAL 79 PASSUSRD IN GATALSG ENTRY 

CACCESS LIST) LIST SF THE GPERATIGNS | ae THE PROGRAM 
WILL BE CARRYING GUT ON THE FILE. MUST 
ONE OF THE FOLLOVINGs APPEND READ, CGPY, 
EXECUTE OR LINK. | 


EXANPLE OPEN ate ee (READ EXECUTE)» 


SRw2 


‘THIS CONHAND REQUESTS THAT A CATALOGUED FILE BE ASSIGNED 
A FILE REFERENCE NUKBER. : 
TYPE GF RETURN: HEANING 
0. ' NGRNAL RETURN 2 4 | 
ae. SRULCO,17) CENTAINS THE FILE REFERENCE 
oe he: NUHBSER ASSIGNED BY THE EXECUTIVE — 
| SRU2(O,31) FILE ACCESS PLIP FLOPS 
foe * 0 ‘0 INDICATES READ PERMISSION 
! O INDICATES APPEND PERNISSION 
(2 0 INDICATES WRITE PERNISSION 
3 O INDICATES EZ fECUTE PERUISSION 
4 THESE BITS ARE. NOT YET USED 
: 2 
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2 } Qe 
(12,35) CONTAINS THE COUNT GF THE 
RUNBER 


3 INBER OF WGRDS.IN THE FILE 
1 -NGT APPLICABLE ae 
2 NOT APPLICABLE - 
3 | UNRECSVERABLE ERRGR 
4 FILE REFERENCE NUMBER (FR) HAS N@T BEEN 


ASSIGNED —. 


O3 > aia  PRGTECTIGN VIGLATION 1.2. THE TYPE GF ACCESS 
_ REQUESTED 18 NOT ALLOYED OR THE PASSUGRD 
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~UAS NST BQAUAL TO THAT IN 
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6.8 | CATALGGUE FR HAS NG ENTRY WITH SAHE FILE NARS 
, | EA ULVALENT 7G "PROGRAM NST SAVED" 3 
OPE SING AN UNCATALOGUE . FILEC TEMPORARY) 
OPEN T 
EXAMPLE GPEN TRAPL 
THIS COMMAND b REQUESTS THE ASSIGNUENT OF A FILE REFERENCE 
NUMBER FGR A FILE WHICH iNT TEALLY CONTAINS O-UGRDS 7 
AND WHICH MAY BE ACCESSED IN ANY ALLOVED HANNER 
SYPE OF RETURN MEANING | 
0 | _sONORMAL RETURN SRUL AND SRV2 HAVE 
7” i . : FHE SAME HEASING AS GPEN POR A. 
| CATALGGUED FILE 
3 a  ~UNRECGVERABLE ERRGR 
6. E | NG SPACE AVAILABLE FOR TEMPGRARY STGRAGE 
| | THIS SHGULD NBT OCCUR 


T 3 BUSY 


_ List 


MFC2 «S852 | JUNE 22,1968 


190 MOLD PILE CS es CCONTE NUED) 
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nes CONMANDS una cH AP PLY GNLY TO ATTACHED FILES 
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156 REWIND, SKIP GR CLOSE Beue Ania. GNLY’ ATT ACHED 
160 UNCATALGGUED FILES CAN BE REFERENCED WHEN USING | 
{7O WE CATALGGUE COMMAND. THE DESTRGY COMMAND 
180 CUHICH DESTROYS A CATALGGUE ENTRY) CANNOT BE . 
182 USED WITH ATTACHED FILES, 


POO. 2 es ee | 
200. READ 7,FR,N JW . ” 
210 .- T FRAP LOCATION 
220 FR © ©. FILE REFERENCE NUMBER 
230 | No NUMBER GF WORDS TO BE READ ©... 
240. °° M..  HENGRY LOCATION INTO WHICH FIRST ORD GoES 
250 2 5 | | : es 
260 «THIS. COMMAND REQUESTS THE NEXT N WORDS FROW 
270 FILE FR BE PLACED IN LOCATIONS Hy U1, coe Be (NED) o 
Oth =< _ Yee Sa 
272 TYPE GF RETURN NEAWING | 
275 OO NORMAL RETURN | 
294 ia END GF RECGRD. (SRY2 CONTAINS HE REST 
275 2 END OF FILE ¢SRU2 CONTAINS THE RES1 
276 3 —"ENRECGVERABLE ERROR 
277 A ... BR HAS NGT BEEN ASSIGNED 
278 5 ‘ss PRGTECTIGN VIGLATIGN 
, 279 a FILE BUSY — 
280 ar | 
3G REWIND T,FR oo ees 
sion SS TRAP LOCATIGN | 
320 FR FILE REFERENCE NUMBER | 
3380 : | 
340° THIS COWMAND RESETS THE READ POINTER SO THAT A 
(850 >. SUBSEQUENT READ cawnAND WILL GEY THE FIRST N 


360  “UGRDS .GF THE FILE 


he as 


Lire& Ue MLIURN HAAN LING . 
NORHAL RETURN 
4 FR HAS NOT BEEN ASSIGNED 
2. : - '  PRGTECTIGN VIGLATIGN. 
| FILE BUSY Pans 


7 «FRAP LOCATIGN By 
FR .. FILE REFERENCE NUMBER: °° 
Ns NUNBER OF WERDS TO SKIP OVER 


THIS CONEAND ADDS N TS THE READ PGINTER,. IT IS. 
EQUIVALENT 19 READING N WORDS INTO A SCRATCH AREA. 


’. 


‘TYPE SF RETURN MEANING | 7 ee te as 
oe eo END GF RECORD (SRV2@ CONTAINS TH 
THE NEXT UGRD READ WILL BE THE @ 
FOLLGUING THE END GF RECORD YGRD = |! 
END GF FILE (SRU2 CONTAINS THE RESIDUE) 
UNRECSVERABLE ERRGR 
FR NGT ASSIGNED 
PROTECTION VISLATIGN | 
| FILE BUSY. ss 
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jNE. 


SIU Ot 


APPEND T,FR,N, 1: ea 
de TRAP LGCATION | 
FR os FELE. REFERENCE NUMBER 


No NUMBER GF WORDS To APPEND Ta. THE FILE 
M HEMGRY LOCATIGN OF THE NUSRDS 


THIS. COMHAND REQUESTS THAT THE N WORDS IN MENGRY | 
LOCATIONS M, Mri,o0. MrCNei) BE ADDED To THE 
END GF FILE FR. 
TYPE GF RETURN MEANING 
. . 36 ; . = NGRUAL RETURN | | | 
fi o- . - >-END @F RECGRD (SRVU2 CONTAINS THE RESIDUE) 
2 - 7. END GF FILE (SRV2@ CONTAINS THE RESIDUE) 
3S  UNRECOVERABLE ERROR. ; 
4 FR NGT ASSIGNED 
5 PRSTECTIGN VIGLATIGN © 
7 FILE BUSY | 
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116 TEMPGRARY CA HED UNCATAL@GUED) FILES CAs BE USED as 

120 A SCRATCH PAD, THAT IS THE CANTENT GF THE FILE CAN BE ae 
(4124 ce THEN EMPTY) WITHS \UT L&SING THE FILE REFERENCE 
128 .NUMEE ALS® TEMPSRARY FILES CAN BE CATALSGUED @R USED © a 
132 TA RE PLACE THE FILE CGNTENTS aF & CATAL@GED FILE. 

149 SCRATC T,FR | 

144 ee TRAP LOCATIAN a 

LAg _ FR FILE REFERENCE NUMBER . 

156 COMMAND. RESETS THE FILE- WORD. COUNT TH ZERG. THE 

160 FILE REFERENCE NUMPER WAY STILL. BE USED F@R READING, 

164° . APPEND ING, ETC. 3 IN-@THER WORDS, SCRATCH PUTS, THE FILE 


163 | * BACK IN THE C@NDITIGN IMME EDIATELY FGLLOVING AN GPEN. 
Lie, | THE CAMMAND IS FULLY EQUIVALENT. T@ A CL&SE Eee 

176 BY AN @PEN WITH A, GUARANTEE THAT THE FILE REFERENC 

1é9o ' NUMBER RETURNED AFTER THE @PEN"IS THE SAME AS THAT. “USED 
174 * SCE SPER PEE | a 7 


192 TYPE’ @F RETURN MEANING 

’ NOARMAL RETURN | 
UNRECGVERABLE ERRGR 
FR NOT. ASSIGNED - | 
PRETECTION VIGLATIAN: 

‘FILE BUSY 
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PASSYERD “3g BE PUT IN 
ES SF ACCESS WHICH 


ENTRY 
WILL BE PROHIBITED 


HE FILE WITH 
NTS 


REFERENCE NUMRER FRO” 
THE CATALAG Of] 


FILE a 
PILE WITH wile RerERence 


CREATED USING THE 


NUMBER FRI, THE. ENTRY WILL BE. | E NAME . 
PASSUARD AND ACCESS PRAMIBITIGNS LISTED .IN-THE MACRS. © 
THE PRSGRAM RETAINS THE FILE AS AN ATTACHED CATALS SGUED | 


FILE @PENED 


TYPE GF 
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0 
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. 5 i 
6 
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RETURN 


FOR ALL oe eo GF ROCESS « 
“MEANING Si 
NORMAL RETURN 
UNRECSVERABL E ERR@R 
FRI GR FR2 N@T ASSIGNED 
PRATECTIGN VIGLATION . -. 
ENTRY WITH SAME NAME IN FRI 
FILE 5US | Se 


BPiyAG Torre ,FR2, AME, PASSWORD tnt ESS PROHIBITIONS) 


‘oe 

FRI 

FRE 

NAME 
PASSWORD 
CA Pd 


REPLAC ‘CAUS 
BY THE “ERITR 
THE CMMMAND 
CATLAG,. 


TYPE OF RETURN 


om) UID OF © 


CATALSG FILE -REFERE 


TRAP LOCATION 
ENCE. NUMBER 
UNC ATALSGUED FILE. oe 
FILE NAME 


TS PE PUT IN ENTRY 


PASSYS vad RD 
TYPES GF ACCESS WHICH WILL BE. PRSHIDITED 
SES Elbe FRe TS REPLACE. THE FILE PaLATED 7 
YCWITH THE SAME NAME) IN CA&TALSG FILE FRI, 
IS EQUIVALENT TO A DE STREY FOLLOWED, BY A 

, $ 

MEANING 

NGRMAL RETURN 

UNRECGVERABLE ERRGR 

FRI @R°FRQ NT ASSIGNED 

PRATECTIAN 


| VIGLATIGN 
FILE BUSY 7 
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FILE COMMANDS (CC ANTINUED) 


CLASING AN dias FILE 


ANY PROGRAM WHICH GPENS A FILE SHOULD CL@SE THAT FILF 
PRTGR T¢ TERMINATING. IF THE PRSGRAM DSES NAT CLOSE 
THE FILE THE “SUBSEQUENT ACTION OF THE EXECUTIVE TS 
UNDEFINED AND WILL PRABASLY 3E UNPREDICTASLE, é 
. THOSE FILES WHICH HAVE SFEN PASSED ALING VIA A SP ANN 
PEGUEST YILL NOT 88 CLOSED BUT WILL 3E PASSED BACK Tf. 
THE JB WHICH REQUESTED THE SPAWN. IF THE 192 WHICH ’ 
PASSED ALONG THE FILE THR@UGH THE SPAWN C@MMAND DID | 
MOT REQUEST THAT THE FILE BE PASSED. BACK THE FILE WILL 3E 
CLOSED IN A NG@RMAL FASHI@N.. THUS THE PRAGRAN SETTING UP 
THR SPAWN IS PARTIALLY PROTECTED FROM THE VAGARISS GF. THE. 
PROSRAM AT THE LANIER LEVEL R LE EVELS. a 
Cheese aR : 
T TRAP LOCATIAN 
FR FILE REFERENCE NUMBER 
IF FR REFERS Ta AN UNCATAL?GUED FILE THEN THE - 
' SPACE ALLGTED IS RETURNED T& FREE ST@RAGE. IF 
FR.PEFERS TA A CATAL@GUED FILE THAN THE GATAL&G 
ENTPY C@RRESPANDING TM THIS FILE WILL BE UPDATED 
(ATTACHMENT LEVEL .DECPRASED AND IF THE PROGRAM APPENDED 
-T&.THE FILE THE APPEND: FF IS RESET) AND IF THE . ) 
FILE H&S ACTUALLY BEEN M@DIFIED IT IS WRITTEN. ON .THE 
INCREMENTAL DUMP TAPE. IN EITHER CASE THR FILE. 
REFERENCE NUMBER IS NO LANGER ASSIGNED -AND MAY BE 
REASSTGNED 8Y THE EXECUTIVE. | : 
TYPE. OF RE TURN. MEANING 
‘0 + * . N@RMAL 
3 “UNREC SVERARLE, FRROR 
4 " FR NAT ASST GNED 
5 | - PROTECTIGN VIGLATISN 
7 we FILE BUSY Py 


ele CATALMAG 
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SOP. | 
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READ T 
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520 
S24 
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352 
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“S340 


O44" 
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352 
356 
360 
361 


364. 


(S6S 


Sle 
376 
320: 


S84 
SRR 
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396 
400 
404 


408 | 
412 


AS 
42.0 
424 


422, 


AS2, 
436 
440 
Aah 
44g 
452. 
456 
4280 
464 
. 468 


472 


AT& 
£77 
ASO 


TATNTENANCE 


9 t 

a. TRAP L&CATI AN , 

FR FILE REFERENCE NUMBER GF CATALSG FILE. 
yo NUNBER OF CATAL@G ENTRIES TO SE READ 
M | CHEMORY LACATIAN | 


ee ‘SAN FDITED Lak AT THE CONTENTS AF THE 

No N ENTRIES 4F TRE CATALSG WITH FILE REFERENCE: 
NUMBER FR. THE INITIAL IMPLEMENTATION WILL RETURN | 
TW3 WARDS PER ENTRY. THE ASCTI CHARACTERS - 
SED AS 4 NAME FOR THE FILE WILL BE LEFT JUSTIFIED. IN 


THE 2 YGROS. ADDITIP@NAL INFARMATI AN WILL. .BE PROVIDED - 


TYPE 


AD. HEC 

AF RETURN MEANING | . 

0 NORMAL RETURN ae 7 

i END AP RECHRD (SRI2 CONTAINS THE RESTOUR) 
wR, ¢ FND SF FILE (SRW2 C@NTSINS THE RESIDUE) 

See UNRECAVERASLE ERRAR | 

A FR HAS NST BEEN ASSIGNED. 

5 PRATECTIGN VIALATIGON ° 

7 FILE. BUSY 

T,FR 
“TRAP LOCATION - a3 
R. 7 FILE REFERENCE NUMBER 


- THIS CSMMAND RESETS THE READ PINTER SB THAT A 


SUSSEQUENT READ C@UMAND WILL. GET THE FIRST N oer 


-  CATAL@G ENTRIES OF THE FILE. 


TYPE - 


TYRE 


@F RETURN “MEANING - 
OF ne NORMAL RETURN _ 
ie os - -~FR HAS N@T BEEN ASSIGNED | 
5 | PROTECTION VIGLATIGN 
oFR,N 7 , 
TRAP LOCATION 
FILE REFERENCE NUMBER 
NUMBER GF FNTRIES TS SKIP OVER 
THIS COMMAND ADDS N TS THE. READ “POINTER.” It's 
KQUIVALENT T@ READING | N ENTRIES: INTS A SCRATCH AREA, 
GF RETURN “MEANING ; 
1 . END AF RECGRD (SRYO CONTAINS THE RESIDUE 
Q END GF FILE cCSRY2: CONTAINS THE RESIDL ae 
3 UNRECOVERA SLE ERR@R 
4 FR NAT ASSIGNED 
5 PRATECTIAN VIGLATIGN 
6 NAME NOT IN CATALGG 
7 ' FILE Busy _ 


DESTR@ T,FR,NAME PASSWORD 


T ' TRAP LOCATIAN 
FRO. 7 FILE REFERENCE NUMBER any CATALOG 
NAME . NANE OF ENTRY T@ BE. DESERAYED: ~= .: 


THIS- COMMAND WILL DESTP SY THE FNTRY WITH THE NAME. 

SPECIFIED IN THE CATALAG FILE FR IF THE USER 
HAS OPENED CATALOG FR FGR WRITING AND. THE PASSHORD: 
SUPPLIED MATCHES THAT IN THE ENTRY. 


TYPE 9F RETURN MEANING 


) 
1 = NARNAL RETURN 
ae Hse ERROR 
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moe 7 2 a “PROTECTIGN . ALATI AN 

& | Na ENTRY WITH. NAME SPECIFIED 
Dk 2 sRELE BUSY: © | | | 
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UDFG. "ISER DEFINED FILE ComManog" 
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20° 3 25 a3 
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240 "~ NEW Ng Ng 68000 3N 
.250 | aE ee 
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290 nee? | 
500 LISt NeB, By oo ° 9B 65. 
310 on | 
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350 | | 
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370 | - 
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£00 SAVE PePs coove SF 
AO mae 
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230°. 4 Peet 
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480 . BUILD N 
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140 * * * A LITTLE STORY ABOUT HE aaLDY DITOR * * x 

145 , : 

750" 
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160 THE MAINTENANCE ZF ALL SZURCE FILES IN MJLD WILL SIRMALLY 
165 BE OONE BY USING THE SYSTEM CALLED " DITOR"? EDITOR en 
170 CAN BE CALLED BY TYPING "RUN DITOR” IF. YSU ARE NIT IN A 
(75 CONVERSATION WITH S@HE OTHER SYSTEM PROGRAM. TF YSU ARE. 

180 IN A CONVERSATION. WITH AN@THER SYSTEM PRYGRAA YSU. MUST - 

165 FIRST EXIT Frew THAT PROGRAM BY TYPING " XiT". en 

190 | 

195 AFTER EDITER 1s IBADED IT WILL TYPE SDITZR AND WAIT FeR _ 

200° A COWMAND TO BE ISSUED. AFTER A LEGITIMATE COMMAND HAS BEEN 
‘205 ISSUED EDITOR CARRIES JSUT THE FUNCTION REQUESTED BY THE COMMAND. 
“210 WHEN FINISHED WITH THE TASK: S)ITOR TYPES @UT “KEADY" AN! 

215 WAITS FER ANSTHER COMMAND. IF HE CSWMHAND HAPPENS Ta BE 

220 UNRECSGNIZABLE @R INVALID FOR SOME REASON "INVALID EDITOR, ; 
225 COWMAND” WILL BE TYPED. AFTER EITHER RESPYNSE TW A CaMHAND. 

230 EDITZR IS READY Tey ACCEPT ANOTHER C¥JMMAND. DURING THE 

255 -SXECUTIZN OF THE COHMAND STHER COMMANDS WILL NeT BE 

240 RECOGNIZED. | ; | 2 , 


‘ 


245 ee . 
250 IN CONTRAST TW THE OXRTHSUTH Gey “SHARING SYSTE“ MLD 
.. 255 ALLOWS & USER TW BE WORKING WITH wRE THAN BNE FILE AT A 


“ROO TLHE. « HIS MEANS THAT EDITOR CUMMANDS SUCH AS UST, 0Sk. RCs 


265 MUST NGW GIVE THE NAME JF THE FILE WHICH IS. Ta BE USED WHEN 
270. EDITOR CARRIES YUT THE CUMMAND. ALSG SBME COMMANDS SPECIFY A 
275 PASSWORD WHICH CAN BE USED AT THE USERS OPTION. | 


285 THERE IS A RESTRICTION JN FILENAMES AND PASSWORDS , NAMELY THAT 
290 THEY MUST NOT CONTAIN: 


295 | Bak . . 

500 |  *d) LEADING BLANKS 
S05 = 22 COLYNS [3] 
510 5) SEMI -CSLUNS C3] | 
oho. = S a BD COMMAS  [- 23 

520 


525 IN THE COMMAND DESCRIPTIGNS BELOW, A “FILE IDEN NTEFIER" IS $F Tae. 5 
950 FOLLOWING FORM: <P TLENANE> ,<OPTIONAL PASSWZ RD > | 


_ RENAME NAMELA; NAMEIBs NAMEQA$s NAMEQB 5 22002 5 NAHIENAS NASIENB 


OLD FILE IDENTIFIER; FILE IDENTIFIERS. isis SELLE IDENTIFIER 


SETS CATALSGUED (SAVED) FILES FSR YSE DURING THE RUNNING 

OF EDITOR. IF A PASSWORD IS INVALID gr THE USER'S FILE 
OIRECTSRY BES NOT CONTAIN AN ENTRY. WITHA FILE WAWE | | 
GIVEN IN THE COMMAND, #DIT@R WILL TYPE "INVALID EDIT C@uM4AND". 
ALL SUBSEQUENT COMMANDS BW: EDITOR RELATING. TS THE FILE - MUST USE 
THE FILENAME CWHICH “AY BE CHANGED BY RENAME). © 


NEW FILENAME ;FILENAWE; «2... 3 FILESAME 


@PENS TEMPYRARY FILES WHICH WILL. BE GIVEN THE. NAMES. WHICH 
APPEAR IN THE COMMAND. ALL SUBSEQUENT COMMANDS RELATING 

TW ONE .YF THESE FILES JUST USE THE SAME .9F THE FILE. | Psa 
TEMPORARY FILES MUST BE SAVED DURING AN EDIT@R RUN OR THEY 
WILL BE IWST YN EXIT PROM EDITOR.. SBS PR ae 
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THE NAMES NAMELA, NAMEQA, .STC., AUST HAVE BEEN USED. 
PREVIGUSLY IN AN @LD, NEW, OR RENASE COMMAND. 
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TE CONTENTS OF THE FILES NAMED ARE LAST BUT THE NAMES ARE 


STILL AVAILABLE FOR USE. IN EFFECT THIS ERASES THE CONTENTS 


®F A FILE BEING USED AS A SCRATCH PAD. | 
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SAME NAME BEING USED IN THE DITOR RUN. IF. THE CATALSG 


CONTAINS A ENTRY YF THE SAME NAME, EDITOR WILL TYPE 


"FILE OF SAME ‘NOME SHALL’ I REPLACE IT?"... ANSWER YES OR NJ. 
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THE GLY RESTRICTIAN GM A UGER'S PROGRAM Te TNSUME C¢ 
WITH UOT IS THAT ALL SYMBOLS SHEYULD REGIN WITH A LET 
THAT BEGINS WITH A-NSN-LETTER CHARACTER MAY MOT BE RI 
4 ODOT COMMAND, | 

TO RUN A PRAGRANM CHHICH! MUST RE STPRED, IN ASS EMALE BY, 


27 


DSS 


as 
WHDER DOT, THE USER MUST.GIVE THE FOLL@WING CaNMAND Ta 
EXECUTIVE, "RUM DDT". WHEN DDT RESPANNS WITH A “ADT. 
WILL ACCEPT COMMANDS - A "LGAD" BELNG THE @RYISUS FIRST 
Hee ae, FOREAT GF DOT COMMANDS oe a 


<ChMMAND: 


MAY BE TYPED GN A 
ND @VER MORE THAN @NE LINE, | 


Nay i. > 
shETAs -CMARE 


<OPTIONAL TEMPGRARY PUTPUT MODE MGDIFIER> 

<Q STRING AF ARSUMEYTS SEPARATED RY SEMI -CCLENS> 
THR @NE. EXCEPTION Ta. THIS FORMAT VILL RE THE SINSLE-CHA2: 
REFERRED Ta 1M 9) ABRVE,  ° | 
FAR THE COMMANDS “CONTINUE” AND "RESISTERS", THE ARGUMEN 
IS GPTIGYSL, FAR ALL C@MMANDS EXCEPT "DUMP" AND "REGISTE 
TEMPORARY @UTPUT MODE MODIFIER WOULD RE MEANINGLESS, 
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Kokok ok oe A NGTE ABGUT NUMBERS Meo se kk 
ALL NUMBERS APPEARING IN ODT CeMMANDS ARE TAKEN Ts BE ¢ 
UNLESS SPECIALLY INDICATED @THERVISE, F@R A FEW INSTRU 
SUCH AS “DEC, THE ACCAMPANYING NUMBERS ARE AUTSNATICAL 
ASSUMED TO RE DECIMAL. TO GTHERWISE ENTER NG@N-GSCTAL NU 
eR GCTAL NUMBERS WHERE ANOTHER TYPE IS EXPECTED, USE GM 
OF THE FALLGWING FARMS: | 
| | 

NNNANN 0. MUMBER TAKEN AS @CTAL * 

NANNUA, °° NUMBER TAKEN AS DECIMAL 

NNNNAN NUMBER TAKEN AS FLOATING PSINT 
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1320 IF THE PASSYARD(S) ARE C@RRECT, | 

a - IN ASSENBLED, BINARY FORM - ARE LEADED INTO CARE Peay 
169 SECONDARY STORAGE. THE. PREGRAMS MUST ALL RE @F. THE SAFF 
170 TYPE - ARS@LUTE GR RELGCATAPLE. NLY GME CORE IMAGE 
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199 THIS WOULD LUAD THE THREE. PREGRAMS "preart. “aRTLts" 
e AND "PHNCHR™ IF "SHAZAM" . "IRAN", AND “CUPFS" YESE 
—_ s eC 

_7A THE C@RRECT PASSYERDS RESPECTIVELY... 
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DO>D NO PO PA HD NPD AD ND 
tS CAA SOND ee 


Vs x a 

2 : 

AD THE SINGLE ARGUMENT IS @HP GP THE § GUTPUT MODE SyereLe 
45 BESTE REL SEP ceME SCR OT Tel. Atl AUurPuT wikis Be 
50 THIS MODE UNTIL A NEY FARMAT COMMAND IS GIVEN, a | 
eee) THE EXCEPTION ISs IF A Se 1S PRECEDED BY Air OUTST: 
260 MIDE SYMBEL, THE SUTPUT PRANUCED 8Y THAT STNELE CaMeann 
263 WILL BE-IN THAT MODE, WEN TIE CUTPUT FRCk THE SINGLE 
270 COMMAND TS COMPLETED, THE GUTPUT -N@DE WILL REVERT Ta THE 
275 MDE SPECIFIED IN THE LAST FeRMAT COMMAND, 
PO | 
235 EXAMPLES: ~ | FERMAT SYM (Rs PORMAT ASCE 
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OQ: 
St 


Sd OUNP <ANDRESS LIST> ° # 


315 | 
B20 EACH ELEMENT OF TUR ANDRESS LIST IS EITHER A SIUGLE ADARESS 
; EXPRESSION, Gh A PAIP AF ADDRESS EXPRESSICNS SEPARATED RY 
a CAuMAS, TNE ELEMENTS @F THE ADDRESS LIST ARE SEPARATED Ry 
Ee SPMI-CALevs, THE C@eNTEITS @F EACH SINGLE LECATIE,. 48) oF 
Zan EVERY LOCATION R@UNDED: (INCLUSIVELY] BY THE ADNRNSS-P4ies, 

345 ANE PRINTED IN THE CURRENT GUTPUT MODE, AMY: NUNRER AF 
[oC ADDRESSES BR ADDRESS~PAIRS MAY BE USED 4S ARGUMENTS To A 
So DUMP COMMAND. | 


a 
nN 
2 


T THE CONTENTS @F THE FIRST lem 
E RG@UTINE GETPT, PLUS LACATIGNS PT! 
HE GUTPUT moe SELECTED BY THE 


375 as THIS YGULD PRI 
33000 LLACATIONS GF T 
S25 3 -AND PT2, ALL 
So LAST "FORMAT 


e 7 FORMAT SYME DUMP GETPT, GETPT+I9.4TAL DUMP PT1;. PTe¢ 

ao DUMP STOPT,STAPLsSTUPFA , a a ae | 
AVS | oO ; 
£20 THIS WRULD PRINT THE CONTENTS @F THE FIRST 20. |. 
42.50 LOCATIONS @F-THE RGUTINE-.GETPT IN THE SYMRSELIC: AUTPUT 
ASO. MADE, THEN THE L@CATICNS PTL AND PTO IN THE TALLY | 
ABS MORE, THEN THE LOCATIONS FRAM STEPT T® AND INCLUNING 
AAD 7 STM@PT1 TM THE SYMRGLIC. MODE, THEN-THE LOCATI®® STUFF 
1 ae | IM THE SYMBSLIC “ODE. | ) 
a55 
AGO 
455 ee 
470 PATCH <SINGLE ADDSESS EXPRESSIG@N> ¢'<4 LIST @F YARN -EXPRESSI GMCS 4 
AT? 7 : 
AGO THE WORD EXPRESSIONS, WHICH, ARE GRPARATEN FRe@M EACH @THE™ 
435 BY SEMI-COLANS, REPLACE THE CONTENTS @F SEQUENTIAL HEMPPY 
AQ LOCATIGNS STARTING AT THE ADDRESS GIVEN Tt! THE | | 
ASS. FIRST ARGUMENT; EVENTUALLY, CERTAIN GRAP PSEUDS-CPRRATICRS 
500 MAY BE ALLAYED To REPLACE A WER EXPRESSIGN AS.AN ARGUMENT, 
eae : _ rt a8 
510 EXAMPLES: PATCH MASK+3:7777777770008 24 =~ 
oe 1 3 pee a ee ae eos . 

“20 THIS YSULD REPLACE YHATEVER HAD REE LN Lecagtres 

F MASK+3 WITH THE SCTAL C@NSTANT 777777777000. 

4 ee | 
Sa5). * PATCH JESTER-3;LDA GET, IDsCMPA AUSTESTZE TRA 

“DAS - 
55» THIS: VGUL DO REPIEACE UUATEVES JAD BES Te LeCaT IG: 
550 JESTER-3: WETH = LRA GET,TA 
555 JESTER <2 WITH. CMPA QUGTE 
560 JESTER] WITH TZE TEA 
55D ' 7 : | 
570 “. PATCH BARFELIeTRA: PAT#.PATCH PATSLDOX 4, F@G2AD% 4,959,903 
575 : TRA PARF+IO# 
580 Bat ected 

‘55 THE GRIGINAL INETRUCTIZN LM LOCATION RAR FLO CQECIMAL) 
590 (REMEMBER THAT THE RARF+L! IN THE PATCH CAMBNANN Ts 
595 ACTAL] WAULD. BE EXPUNGE! . THE PRYSRAM WOULD TRANSPRS 
are) Ti THE INSTRUCTION IN L@CATIGN PAT. “PAT" MUST HAVE 
A, REEN DEFINED SGMEWHERE, AND THE THREE LPCATIGNS Pat, 
610 . PAT+1, AND PAT+2 MUST BE AVAILABLE (FPR GVERYSITING,.. | 
515 AS ANY CONTENTS THEY MAY HAVE HAD WCULN BE OES TPFYRD 
620 RY THE SEC@ND PATCH CANMAND, 
625 3 
649 
655 


) - 
S40 CONTINUED TN MS DDT 


OLD ee 
GLD PROBLEM NANE=-MSDDT 


READY. 
LIST 


HSDDT 15849 JUNE 22,1966 
100 Last CHANGE: HEREs 1831, 20/6/66 
105 | 7 
110 
115 | | z 
125. BREAK SALLY STEN) oLL12 ,UL E> g| “ALQ1,L12},LIZIULZI> -3 sooo 3 
13000 a ae ‘ <AINI,LENISLINI,UINI= 2 
1550 ee | | ae 
140. THERE ARE RESTRICTIONS GN THE LOCATING BF BREAKPOINTS; 
145-00 THESE ARE GIVEN AT THS END GF THE SECTION DEALING WITH 
150 THE BREAK CSHHANDS. | a 
“455 e 3 = a3 * eek | 
160 -. ) SINGLE BREAK COMMAND CAN EMBED ANY RUNBER OF BREAMPOINTS. 
165 7 EACH BREAKPGINT. SPECIFIED TAKES A LIST OF 1.79 4 ARGUMENTS, 
170 | EPARATED/BY COMMAS, THE ARGUNENT LISTS FOR DIFFERENT 
175. : BREAKPAINTS ARE SEPARATED BY SENI@COLONS. AS THE ACTIG} 
iso. DEPENDS 3N THE NUNBER OF ARGUMENTS SUPPLIED, FOUR CASES 
185 ARE CONSIDERED. | 
190) | | Oo 
195 IN EACH CASE JHE FIRST ARGUNENT, AlN}, IS THE ADDRESS aT 
200 '.. YHICH THE BREAKPGINT IS INSERTED. IF ALN] 18 THE ONLY 
205 — ARGUHENT SUPPLIED, THE PROGRAN MALTS, DD? PRINTS THE 
210 BREAMPGINT MESSAGES "BREAKPGINT AT LOCATIGN ALN]°, AND 
215 - AWAITS A COMMAND FRGN THE CGNSSLE. THE INSTRUCTION IN THE 
220 LOCATION WHERE THE BREAKPOINT IS INSERTED IS NOT EXECUTED 
225 ° BEFORE THE BREAK TAKES PLACE. . | 
230 | % | | 
255 EXAMPLES: BREAK CRUNCHY Ca 
240 - . , | i 
BAS WHEN THE PROGRAM REACHES LOCATION CRUNCH, THE 
250 . |... INSTRUCTIGN THEREIN IS NST EXECUTED, THE NESSAGE 
255 | OBBREAKPSTNT AT LOCATION CRUNCH” IS PRINTED. THE 
260 SYSTEH AWAITS A TYPED C@MMAND, WHICH DETERMINES THE 
265 + NEXT ACTION. IF, FOR EXAHPLE, THE USER TYPES IN THE 
270. ee COMMAND "CONTENUS? (JT THOUT ARGUMENT), THE INSTRUCTION 
275 IN CRUNCH “Ts EXECUTED, AND THE PROGRAN CONTINUZS. 
280 - . THE BREAXPSINT RENAINS SET, SO THAT THE PRSGRAY Is 
Go (AGAIN INTERRUPT ED IF AND UHEN CRUNCH IS REACHED AGAIN. 


WwUY 


299 CONTINUED IN MADDT 


o 


305 THE ACTION IS IDENTICAL TS THE PRECEDING EXAUPLE, 

310 EXCEPTING THE APPROPRIATE CHANGE OF LGCATION IN THE 
315 HESSAGE; IT GCCURS GN EVERY ARRIVAL AT SNAP, CRACKL 
320 OR POP. 

325 - 

3550 | . 

335 oo 

340 BREAK COHMAND YITH 2 ARGUMENTS 

3.45 | 

350 ‘IF TUG ARGUMENTS, ALN) AND TIN], ARE SUPPLIED TS THE BREAK 
355. _ COMMAND, ALN) IS AGAIN THE ADDRESS UHERE THE BREAKPOINT 
360 IS INSERTED, AND I(N] IS THE PETERATION COUNT s 

365 oe , ete = 
370 IF TiN}>0, THE BREAKPSINT IS IGNORED. EXCEPT THAT LIN) IS 
375 DECRENENTED BY SNE BACH TIHE THE PROGRAM REACHES LOCATION 
580 ACN]. WHEN TiN) REACHES ZERO, GR IF THE PRGGRANMER HAS 
(385 -. SPECIFIED I{N]=0, BREAK ACTIGN TAKES PLACE AS IP NO ICN]. 
390 HAD BEEN SPECIFIED. | patie 

395 ae 

400 IF I{N} HAS BEEN SPECIFIED <0, 9M BYON PASSAGE THRU LacaTia 
AOS AUN) THE BREAKPOINT HESSAGE 25 PRINTED AND If1) is | 
410 INCREHENTED BY 1. WHEN TIN] REACHES ZERO, BREAK ACTION 
AS TAKES PLACE AS IF NO. T(N] HAD BEEN SPECIFIED. = 

420. | | i 

425° IF IINJ=0, IT IS NOT FURTHER INCREMENTED GR DECRENENTSD. 
450 7 7 : Le . } a3 . - . iy ze . 

4355 aoe a: ; ae 

440 EXAUPLEs BREAK. VEBUER ,-39.5NDU333 , O3SEEER ,SIGHT+773 

£50 THE BCTION: . (ON EVERY ARRIVAL B2 tOCATION VAGUER. 
455. THE BREAKP@INT HESSAGEs “BREAKPOINT AT LOCATION 

460 | ‘VEEUER” TS PRINTED; SN THE 40TH AND SUBSEQUENT 

465 ARRIVALS, CONTROL IS ALSG TRANSFERRED 790 THE CONSOLE 
470 GN EVERY ARRIVAL AT LOCATION WOWS33, THE BREAKPOINT 
AT5 MESSAGES “BREAKPOINT AT LECATIGN NOUSSS° IS PRINTED, 
480 AND CONTROL IS TRANSFERRED TO THE CONSGLE. - 

Ag5 ON THE (SIGHT+64) TH AND SUBSEQUENT ARRIVALS AT LOCATI 
490 ‘SEEER, THE BREAKPOINT HESSAGEs “BREAXPGINT AT LOCATIG 
495 SREER" IS PRINTED, AND CONTROL IS TRANSFERRED 79 THE 
500 - CONSOLE. . 
505 | ee } 

510 THE ABOVE EXANPLE ALSO ILLUSTRATES THE DECIUAL AND 
515 ~GCTAL NUMBER CONVENTIONS. THE "O° IN °NSUS533° IS. 
520 ACCEPTABLE, BUT UITHGUT EFFECT, AND COULD BE GHITTED. 
525 a | | 
530 

535 | | 

oe BREAK C@MMANDS WITH 3 AND 4 | ARGUE NTS: SEE NEXT FILE 

550 


QLD ; | 
@LD PROBLEM NA ME~-MADDT 


READY. 

LIST 

MADDT 13:50 JUNE 22,1966 

100 JAST CHANGE HERE: 1835, 20/6/66 

105 | : ae 

110. 

115 

120 

125. BREAK Couann WITH 3 ARGUMENTS: 

450; ven, EE at 

135°. IF THREE ARGUMENTS ARE SUPPLIED W HE BRESK COMMAND, ACN) 
140. . AND TIN] ARE AGAIN’ HE ADDRESS WHERE THE BREAKPOINT IS Ty 
145  . BE INSERTED AND HE ITERATIGN CUNT RESPECTIVELY. THE. 
150° | THIRD ARGUMENT, LIN],.IS HE ADDRESS uF a LOCATIGN WHSSE 
To) 5 CONTENTS WILL BE PRINTED UT ALONG WITH THE BREAKPOINT 
160 «<= MESSAGE WHENEVER HAT 1S PRINTED. SEE THE 2-ARGUMENT 
165: BREAK C@HMAND FOR DETAILS OF THE SIGNIFICANCE OF-I(W1-. 
170 7 | | 


175 EXAMPLE: . | BREAK SMASH 17, JUNKIE CRASH ,0,MUSHs 43 L0S 4-3, F2UN# 
185° -. HE ACTION: Si HE 16TH ‘AND SUBSEQUENT ARRIVALS AT 


b90r3 9 gy IGCATIGN SWASH, HE BRESKPZINT MESSAGE: "BREAK- 
195 ss PYINT AT WCATION SMASH” AND THE CONTENTS oF 
200 ao IGCATION JUNKIE ARE PRINTED, AND CONTROL 18 

205 = - "TRANSFERRED T WHE CYNSSLE 

210: ms + @N EVERY ARRIVAL aT LsCATION CRASH, THE BREAKPYINT. 
215 |  WESSAGE: “BREAKP@INT AT LYCATIZN CRASH" AND THE 
220 » 3 CUNTENTS BF IWCATIGN AUSH ARE PRINTED, AND CONTROL 
225 «YS TRANSFERRED WW. HE CONSSLE; cs 
230 “ @N-OEVERY ARRIVAL: AT LsCATIGN EXAM, THE BREAKPSLET 
235 -. . 7. ° “HESSAGE: "BREAKPQINT AT LOCATIAN EXAN" IS PRINTED, 
240 ae AND CONTROL IS TRANSFERRED Té THE CuNS4Lé; 

245 .* QN EVERY ARRIVAL AT LICATIZN IOS, THE BREAKPBINT 
250 |. MESSAGE: “BREQKPSINT AT IWCATIUN "1gS" AND THE 

255 an CONTENTS OF LWWCATIZN FOUN ARE PRINTED; . 

260 UN THE FOURTH AND SUBSEQUENT ARRI IVALS AT LOCATION 
265 - IS, CONTRSL IS TRANSFERRED T- THE CONSZLE. 

270 © 7 a eG ir 

275 

280 

285 BREAK COMMAND WITH 4 ARGUMENTS 

250 - , die 8g, tae 

295. IF FOUR ARGUMENTS ARE SUPPLIED TW HE BREAK COMMAND, ALN] 
300  . AND. ICN] ARE AGAIN THE ADDRESS WHERE THE BREAKPZINT IS Tu 
305 BE INSERTED AND THE ITERATION COUNT RESPECTIVELY. THE 
310 THIRD AND FOURTH ARGUMENTS, L(N] AND UCN], ARE TE LOWER 
315 | AND UPPER BOUNDS UF HE BLOCK @F MEMSRY TW BE PRINTED GUT 
320° . AL@NG WITH THE BREAKPOINT 4ESSAGE WHENEVER THAT IS PRINTED. 
325 ALL WCATIONS FROM LIN] TO ULN] INCLUSIVE ARE PRINTED. - 


530 , SEE THE 2-ARGUMENT BREAK COMMAND FOR OETAILS af - 
555 | TE SIGNIFICANCE OF IN]. | 


7 nN : : . ; : “ 


THE ACTIGN: WN THE FOURTH . Ato SUBSE QUENT ARRIVALS 
AT IWCATION CHAYS , THE BREAKPSINT MASSAGE ee 
_ “BREAKPOINT AT IGCATION CHAGS" AND .THE CONTENTS 
; = | OF LICATIONS KEG THRU KEG+14( DECIMAL) ARE PRINTED, 
: AND CONTROL IS TRAWSFERRED - TS THE CeNSSLES. 
UN ,EVERY ARRIVAL AT LSCATICN QUEST ,. THE BREAKPSINT 
MESSAGE: “BE (EAKPZINT AT IWCATIeN: Que cSt" Ado TRE . : 
CONTENTS #F LOCATIZN PANDSR ARE. PRIv VTED, AND CONTROL. 
IS TRANSFERRED TO THE CENSDJLES . in ane ; 
YN EVERY ARRIVAL AT: eae) Sa FET Y CLF ZU EVER 
MAKE IT). THE BREAKPOINT SAGE: "BREAKPOINT AT : 
IBCATION SAFETY" AND THE CONTENTS OF ALL ISCATIZNS 
SHELTR THRU H@ME ARE. PRINTEDS$ | 
UN THE 99TH AND SUBSEQUENT ARRIVALS AT LOCATION 
. SAFETY , CYNTROL [Ss ALSO TRANS FERRED . TW THE CONSSLE. 


x x & RESTRICTIONS @N BREAKPOINT IWCATION? © # ee e+ 


IN ORDER TS SSTABLISH THE BRESK PYINT, DT MOVES THE INS TRUCTIGN 
ORIGINALLY FOUND-IN THE eae ee TW AN JUNSPECIFIED 


- IGCATIGN, AND REPLACES IT WITH A TRANS BW THE ODT RgUTINE 


WATCH EX EC UTES THE. BREAK. THIS" WES | OT ‘APPEAR Ww. TAS. USER 
DUMPS , PATCHS, ETC., WIRK AS IF WE ORIGINAL INSTRUCTION WAS WHE 
IT STARTED. eae RESTSRES ‘HE @RIGINAL INSTRUCTIGN Ts Ts 
RIGHTFUL PLACE. | a . ) 


DOT, THEREFSRE,. HAS DIFFICULTY CSPING WITH BREAKPSINTS PLACED 
AT INSTRUCTIGNS WHICH DEPEND JN THEIR LOCATION FOR PROPER 


EXECUTIGN. IC MODIFIED INSTRUCTIONS CAN BE ACCEPTED 
FOR BREAKPZINTS , BUT THE FOLLOWING ARE PROHIBITED PLA 


1) 4 PROGRAM M3DIFIED LOCATIONS 


2) INSTRUCTIGNS WBE EXECUTED BY. AN XKEC JR XED 


UNBREAK <ADDR RES S uST> #. 


THE ADDRESS LIST MAY BE. @NITTED, GR JAY CONTAIN ANY NUNBEI 
BF SINGLE ADDRESSES SEPARATED BY SEWI-CGLONS. IF Né ADDE 
LIST IS SUPPLIED, ALL BREAKPSINTS ARE REMSVED;  STHERWISE 
THE BREAKPYINTS ARE REMYVED FROM THE ADDRESSES SPECIFIED. 
EXAMPLES: UNBREAK CHAOS ;SAFETY# 
THIS WOULD EXPUNGE THE FIRST A AND LAST BREAKPOINTS: 
INSERTED BY THE PRECEEDING SXAMPLE;. THE BREAKPuIN 


AT. "QUEST" WIULD REMAIN. 
UNBREAK # 


THIS WOULD EXPUNGE ALL BREAKPZINTS CURRENTLY SET. 


bree contd Iv MWSOOTy 


QLD 


@LD PR@BLEN NAME--MSDDT 


READY. 

LIST 

MSDDT  .13:53 JUNE 22,1986 

100 LAST CHANGE HERE: 180C, » 20/6/66 

105 : . , 

110. 

1150 } | 

{20 eS > Bina 

125. CANTINUE <OPTIONAL ITERATI@N COUNT = # 

130 aes a rr 

135 EXECUTI@N- GF THE PRAGRAM RESUMES, THE NEXT INSTRUCTI2N 
140 EXECUTED IS THE INSTRUCTION -AT THE: BREAKPSINT L@CATIGN. 
145° IF THE GPTIGNAL SINGLE ARGUMENT IS SUPPLIED, THIS REPLACES 
150 | THE ITERATION COUNT, IfN}, FOR THIS BREAKPOINT. 

155. | , a ce. he oe ee" 

~50 EXAMPLES:. CONTINUF #4 

10 _ EXECUTISN @F THE USER'S PROGRAM CONTINUES FR@M THE 
175 | BREAKPGSINT INSTRUCTION, WITHSUT FURTHER CHANGES. 
180 7 oy 3 : 

185 CONTINUE -9. # 

190 | | a ee a = re 7 2 
195 EXECUTIGN OF THE USER'S PRAGRAM CONTINUES FROM THE 
200 BREAKPGINT INSTRUCTION: cHE ITERATION COUNT, ILNI, 
205 FOR THIS BREAKPSINT IS RESET T@ -9. ; 

210 , 

215 

220 | | 

225 oes eat ete. 3 

230. TRANSFER <SINGLE ADDRESS EXPRESSIGN> # 

235 | : | a 

240 EXECUTI@N OF THE PRA@GRAM COMMENCES, @R RESUMES, AT THE 
245 INSTRUCTION IN. THE: L@CATION WHESE ADDRESS IS SUPPLIED AS 
250 THE SINGLE ARGUMENT. THUS, AFTER A BREAK HAS BEEN 

255 | EXECUTED, CONTRAL MAY BE TRANSFERRED TS ANY L&CATIGN 

260 DESIRED. * : ~ 

265 . ae oe 

270. EXAMPLE: TRANSFER TAREND- TABLENT3. # 

273° a ; : ) 

22.0 » <P ISSUED AFTER. THE eee) EXECUTION @F THE 
5 - PROGRAM COMMENCES AT ‘(TASEN TABLEN+3) : TF ISSUED: 
30 AFTER CANTR@L HAS REEN TRANS? ERRED TS THE CONSOLE 
L235 _ AT A BREAXP@INT, EXECUTION OF THE PROGRAM RESUMES 
300 AT (TABEND-TASLEN 43), RATHER THAN AT THE INSTRUCTI 
505: AT THE BREAKPGINT, AS WOULD BE THE CASE WITH A 

310 . "CONTINUE". | | 
S15 | 
oe 


REO OTE? <OP1TLANAL LIS!) OF REGISTER IDENTIFIERS> # 


THE ARGUMENT LIST, IF SUPPLIED, IS A LIST 
IDENTIFIERS. (A, @, 4, FTC) SEPARATED Sy SENICGLONS., "Hie. 
CQ@NTENTS OF THE REGISTERS SPECIFIED ARE PRINTED, UF.NS 
ARGUMENT IS SUPPLIED , THE CONTENTS. GF ALL REGISTERS | . 
[A, @, E, BAR, 12, ECs. M85: Vig aoke og XTT-ORE PRINTED: 


1. 3 
Lee TNE X REGISTERS ve Pls: BIC. ARE SPECIFIED IN THE. 
ARGUMENT LIST BY NUMBER - ZNLY AS XNe i Sa 


a 


| EXAMPLES 1 REGISTERS E:0:2 é 


TME CONTENTS @F THE THREE REGISTERS: £, 
Q, AND X2-ARE PRINTED. 


"REGISTERS # 
THE CINTENTS GF ALL REGISTERS. ARE PRINTED. 


ALTER <REGISTER IDENTIFIER, EXPRESSIZN>$ cacce ? 
os “<REGISTER IDENTIFIER, EXPRESS ON> rn 


THE CONTENTS. OF EACH REGISTER SPECIFIED ARE. REPLACED 
2: THE CARRESP NDING EXPRESSI@N. . tee 


— EXAMPLES neers Q, LOWBND $5 JO37741: 10 TESTE ,22. Fo 


- THE CaN TENTS ‘OF THE: a | ; 
Q. REGISTER ARE |] REPLACED BY “LOWBND 


7; rn eh 037741 


Rie 4 te ue “SB 22<DECIMAL) 


SAYE <PRAGRAM NAME> ¢ | 
THE PROGRAN(S) CURRENTLY L@ADED ARE SAVED UNDER THE NAME 
SUPPLIED, ALL BREAKPOINTS, PATCHES, ETC., ARE PRESERVED 
AS THEY STAND. ee, 


EXAMPLE: SAVE TRASH @ 


TE LIE — AUTPUT MADES OVAILASLE © \ \ 


ANE ON 
ANY OF THE F@LLAWING & SYHRGLS. MAY on sce AS THE. ARGUMENT 
se ane “FORMAT™ C@MMAND ¢ . . 
Syl SYMP ALIC MSDE THE CONTENTS @F THE LOCATIZN ARE PRINTED 
. AS A MNEMSNIC “APERATI AN CADE FOLLOWED BY A SYHASLIC | 
ADDRESS AND AN ADDRESS MSDIFICATION FIELD. THE ADDRESS 
WILL BE PRINTED AS (NEAREST SYMB@L<ADDRESS+OCTAL 
CANSTANT)-IF N@ SYM2SL ALGNE APPLIES, IF THERE IS N& 
MNEMONIC WHICH CARRESPONDS TG THE GPCSDE PORTIGN GF THE 
WARD, THE SUTPUT N@DE IS CHANGED TS SCT FOR THE @NE WeRrp 


ONLY, AFTER WHICH IT REVERTS: ‘TS SVs 
$ 


DEC DECIMAL M@DE. THE CONTENTS GF THE LOCATION ARE PRINTED 
AS & FIXED-PAINT DECIMAL CONSTANT ee ae 


@CT ‘OCTAL MADE. THE CONTENTS @F THE LG@CATIGN ARE ee 
s A FIXED-P@INT @CTAL COSTAE : | a 


FLG  -FLGATING P@INT MODE. THE CONTENTS “OF THE LacaTIat ARE 
+ PRINTED AS A FL@ATING PAINT CONSTANT. | 


RY CODED DECINAL MSDE. THE CONTENTS OF THE LacaTia Lan. 
PRINTED AS 6 ALPHA-NUMERIC CHARACTERS (S BITS RACH). 


BINA 
ARE 

i] S4DE. THE CONTENTS @F THE LOCATIGN ARE PRINTED AS” 
ALPHA-NUMERIC CHARACTERS (9 BITS EACH). a Co 


HAL | HALF-WORD MADE. THE C@NTENTS GF THE LOCATION ARE PRINTED 
: AS’ TWO SYMBRSLIC ADDRESS EXPRESST ANS C18 2 TS EACH)". 


TAL TALLY. MODE. THE CANTENTS OF THE L@CATIQN ARE PRINTED AS 
“ -" "& SYMBGLIC ADDRESS, -A TALLY CSUNT, AND 6 MGDIFICATIGN 


BITS WHICH WILL BE PRINTED 4S 2 GCTAL DIGITS. - 


5 IF YOU HAVEN'T FIGURED IT OUT BY NoW, RETURN TY GO AS THERE. — 


-AINT Na Mg 


. Beste ace oeok ie tk ok kek eke ok koi kK END) MAL DY DD Toss ook ok ale oe ote de ake 2k abe afc ofc ois 2h fe 2g Di of ah ob abe af ak is af ak fe oh oe abe 
. . tO 5 - 4 . “ “a 


GHAP|-PHASSE 0 
APRIL 20, 1966 _ 


‘THIS DICUNENT CONTAINS A USER DESCRIPTION OF THE @MAP To BE 
PROVIDED GN THE PHASE O MOLD SYSTEM. 


UPON RECEIVING CGNTRGL- GHAP ILL REQUEST INPU 


| UT FROM THE 
TERHINAL, IN GRDER TO GET ITS GPTIGN PARAMETERS CTHESE may’ BE 
TYPED WITH . THE “RUN GHAP® CONMAND IF LISTEN GR.OTHER INITIATING 
MODULES PRESERVE AND TRANSMIT THE REMAINDER OF @HE’ INPUT LINED. 
AT LEAST a FIELDS, COHMA SEPARATED, WILL BE EXPECTED.’ THE 
FIRST FIELD WILL BE THE NAME GF THE SGURCE FILE, THE SECOND 
FIELD WILL BE THE NAME OF THE BINARY GUTPUT FILE, UNLESS IT Is 
“NBIN® IN WHICH CASE N@ BINARY GUTPUT WILL BE PRODUCED, THE 
THIRD FIELD WILL BE THE NAME OF THE LISTING FILE UNLESS IT Is 
SDUCED. - AN 


o 


"NLSTGU" IN WHICH CASE: N@ GUTPUT LISTING uti BEF 
GPTLCNAL FOURTH FIELD HAY CONTAIN ETHER “SYNT 


AB’ GR PNSYHTAB® » ° 
THESE WILL FORCE GR INHIBIT RESPECTIVELY THE OUTPUTING GF THE 
SYNBGL TABLE FOR DDT. IF IT is ‘NOT PRESENT NSYHTAB WILL BE 
ASSUMED. eee ) 
SEVERAL FEATURES FOR GENERATING /ASCIZ CONSTANTS WILL BE 


PROVIDED. THE PSEUDS-9P “ACI CGRRESPGNDS TS THE PSEUDS-gP °BCI* 
‘BUT PRODUCES~ ASCII RATHER THAN BCD CHARACTERS. THE “A° 
“SPECCIFICATION IN LITERALS OR “VFD" PSEUDG-SPS. ALSG GENERATES 
ASCHIg 0 - -_ 


CERTAIN FEATURES GF GECGS GHAP 
GF THE EXISTENCE GF A CONPREHENS BOLTANG S1S 15h YETHIN TNE 
@PEPATING ENVIRONHENT THE FILE MAINTE NANCE (I.E. ALTER) FUNCTIONS. 
WILL BE DELETED. SINCE GNAP WILL BE INDEPENDS Nf OF THE DEVICE GN 
WHICH THE FILE IS MAINTAINED, THE CGHPRESSED DECK FEATURE WELL FP 
CSURSE ALSG BE REMOVED. -IN ADDITIGN, SYS 280 HACR iad WILL NST, AT 
Les ST AT FIRST, BE PRSEVIDED. - 


NOT BE PROVIDED. BECAUSE 


| INPUT WILL BE FREE FORMAT,  FOLLGUING ROUGHLY TSAP 
CONVENTIGNSs nee | : eae 


<LABEL>3 <9PCODE><SPACE><VARIABLE FIELD>"<CGMNENT><: GR <CRe> 


GHAP © VELL {pepe END ON THE FILE SYSTEM FOR C@HHUNICATIGN VITH 
TEE TERMINAL, FOR LECATING USER FILES, FOR CREATING AND DELETENG 
ITS SCRATCH FILE, AND POR READING AD WRITING ALL PILES. ALL 
GSTHER GPERATIGNS WILL BE INTERNALS SHE PHASE..O SYSTEH WILL 
REQUIRE L NEGTHER REQUEST NCR 


AN INITIAL NEMGRY ALLOCATION AND UEL 
RELEASE MENGRY UNTIL TERMINATION. 


BLD | 
GLD PROBLEM Na M E=-LDI NIT 


READY. 
LIST 


LDINIT +-14:00 JUNE 22,1966 


0. 6/21/66 (RPL) Boe fas he 

100 INITIAL VERSION OF THE GOLD’ WADER 

110 a -_ | 

120. i. ae 3 
130 THE FIRST VERSION OF THE “@LD IADER WILL BE MUCH SIMPLER THAN 
[40 THAT DESCRIBED IN MLAD! AND ALOAD2. ° THE COMMANDS WILL BE 
(150 SIMILAR BUT SIMPLER. HERE ARE THREE BASIC CodMANDS: 

160 

170 Wad NAME ,PASSWORD | 


185 START. 
AOS eS 
~ 190 BPTION XX Os oa & E- ZZL : ee gots @ 
200 . KKK oYYY s AND ZZZ es @PTIONs. PRSU THE’ LIST. THAT FSLLO¥S. 
220 THE oP TIONS ARE: _ 
250 eam eee 18 tet ees | 
240 ‘MAP HIS. WILL CAUSE. A MEMORY WB BE PRINTED: oN THE. Geek Tires 
250 — 
260 comMen N HIS WILL CAUSE A BLECK Yr N WORDS Dy. BE RES SER VEDAS |x « 
270 | 6 COMMON: AT THE BEGINNING. uF THE PRIGRAM. 1 THIS MUST. 
275 c ON THE TELETYPE . a 
280 ee APPEAR BEFORE. THE FIRST PROGRAN IS WADED IF IT IS 
290 ao 4 B. BE eed Rete 2F g 
~ 310° USE: NAME CN THIS WILL CAUSE THE SYMB@L WANE. TJ BE ENTERED INTS | 
— $20 oe THE WAD TABLE AS A oes COMMON. REGION gF.SIZE Ne. A 
350 |  BLGCK UF N WORDS WILL BE SERVED AT THIS PYINT IN THE 
340 - PROGRAM FOR HE LABELED a ae REGISN. | ae 
350 
560 “BEGIN SYMDF_ THIS WILL CAUSE. HE. CATION OP He SY4BL8 SYMDF 
570 - . 7 BE TAKEN AS THE TRANSFER ADDRESS INTY THE PRIGRAM. . THE 
580 | | SYMBZL SYMDF #UST BE DEFINED AS A oy {Der IN ONE OF THE 
390° :s POR lh BEING IGADED. | . 
400 | 
410 , BRIGIN N THIS WILL CAUSE THE PROGRAM U BE ‘1GADE wD WITH A BASE 
415 Sead se N' CALL PROGRAMS WILL BE LWADED AS SLAVE 
420 PREGRAN THE FIRST PROCEDURE WILL Be L3ADED AT SLAVE 
450 ADDRESS ae OR ABSOLUTE ADDRESS 64... 1F N IS NOT 
440 a SPECIFIED THE BASE ADDRESS WiLL Bre AT 1024. 
450 : 


460 T IWAD A PREGRA 4 Y@U MUST FIRST SPECIFY THE SPTI“NS YZU WANT Ty 
470 USE BY THE OPTION COMMAND. IF YOU*DO NOT NEED ANY FINE. | 

480 Y@U TKEN USE THE IMAD CEMNMAND. AFTER THE PRSGRAM HAS BEEN. 

490 WADED YOU CAN ELTHER RUN IT BY USING THE START CUMMAND ©R LZAD 
900 ANZTHER PROGRAM WITH THE BPTION AND IWWAD COAMANDS. 
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OLD PR@BLEM NAME--MLGADI 

READY. 
“List. 

MLGAD 1 14:06 JUNE 22,1966 

0 .6/20/66 CRPL) 

100 MALD LOADER 

105 a? 

110 : et ee oe ; 

115 THE. WILD LAADER WILL BE A MADIFICATIGN SF GEL®AD, THE LARGEST 
120 CHANGE WILL BE THE ELIMINATIAN @F THE DEBUG FEATURES AND THE 
125 ADDITIGN OF CERTAIN OPTIONS TM CREATE & FILE WHICH IS A CARE 
130 IMAGE- GF S@ME PRAGRAM. MAST AF. THE @THER GELGAD @PTI2NS WILL 
155 STILL BE AVAILABLE.. -— | | | 
(140 | a ree 

145 

150° LAADER COMMANDS 

155__ fone 7 ie 

160. L@AD NI,P13N2@,P2:...3NN,PN . 
<a | . 4 ae : 

170 THIS IS THE C@MMAND T@ LGAD WITH STANDARD @PTIAZNS.- THE 
175 N'S ARE FILE NAMES AND THE P'S ARE PASSWORDS, THE FILE 
10 NAMES AND’ PASSWSRDS ARE SEPARATED By COMMAS AND DIFFERENT 
185 FILES ARE SEPARATED BY SEMI-CYLENS, PASSWERDS ARE. | 

190 OPTIGNAL., IF THE FILE DAES NOT NEED @NE USE A SEMI-COLGN 
191 AFTER THE FILE NAME IF MGRE FILES ARE TS F@LLoW. 

195 bre 3 ; “. 3 

200. + @PTIGN XXXsYYY:Z2ZZ. hts 

205 i ee” | a : | 

210 IF IT IS NECESSARY TS USE SSME SPTIGNS ATHER THAN THE 

215 STANDARD @NE-S THEY MUST BE SPECIFIED BEFORE THR L@AD 7 
220 COMMAND. THE NEXT L@&D COMMAND WILL THEN BE EXECUTED WITH 
125 SPECIFIED @PTIANS. THE @PTIGNS SHSULD BE SEPARATED By . 
230 | SEMI-COLGNS SINCE SOME GF THEM WILL HAVE IMBEDDED CoMMAS. 
255 A LIST OF @PTIGNS F@LLG@WS WITH THE STANDARD SPTISNS SPECIFIED. 
240 : : oo | | 
245 1... MEMORY HAP OPTIONS | 

250 *. | Z 7 ie ee 

255 NOMAP. N@ MEM@RY MAP IS PRADUCED.. THIS IS STANDARD, 

260 MAP XXX PRODUCE A MEM@RY MAP AND PLACE IT IN FILE xxx. 
251 + 2 ‘THIS FILE (EXCEPT FOR TTY) MUST BE @NE THAT DSES 
262 ‘NOT ALREADY EXIST IN THE USERS CATALOG. | ne 
[ES : pat ; : 


“+ @ af a mew we” © &e Se ee eee, 8 Re 


NIGH DOES NAT EXECUTE 4F TER LOaDINa. THIS iS STANDARD. 
a THE L@ADER WILL WATT a ANSTHE R COMMAND. TRIS CZULD 
RE & G@ GR ANSTHER L& 
CONGS EXECUTES THE IGP eee “a FATAL ERROR gCCURS. OR THE 
ERRAR COUNT EXCEEDS THAT SET By ERCNT.. 
DETECTED DURING LASDING 7 
Ga EXECUTES THE JOB G@NLY IF N@ ERRORS @CCURRED DURING 
: LAADING. . 


3. SET MEMORY OPTIANS © 


SET N SETS ALL#CATED NENARY T9 SCTAL PATT ERK SPECIFIED . 
BY N CWEM@RY IS NURMALLY SET T@ ZER@). eae 


. 44 SET MA XIMUM FRROR Calne 


TS A LIMIT CN) 3 THE NUMBER @F FATAL AND NONFATAL 
ROR MESSAGES WHICH MAY BE PRINTED BEFORE LAADING 
; 


-ERCNT - 
. *R 
IS ABORTED. THIS COUNT IS NORWALLY SET AT 150. 


36 SYMREF AND SYNDEF OPTIANS — 


NASREF NO SYMREF* S ARE PRINTED.: THIS IS STANDARD 
“SYMREPF CAUSES ALL SYHREF'S FGR A LOADED ROUTINE 

TA BE PRINTED WITH THE NENORY “MAP. 
NOSDEF N@ SYMDEF'S WILL. BE -PRINTED. ‘THIS. is 
SYMDEF SYMDEF'S WILL BE PRINTED WITH: THE MEM 


STANDARD 
iGRY MAP, ~ 


6. LOW COMMAN aPTI ON 


-LACOMN CAUSES ALL LABELED CoMMoN Ta BE ASSIGNED BELGy 
BLANK CaMMaN. | eo | 7 


7, SETUP OPTION 


&. FILE CANTR@L BLOCK SPTIGNS . 


Ba; 


9, SYMBAL TABLE ADDITIONS 


USE NAME /SIZE/, NAME] NAME? 
THIS” PERMITS THE USER TO INSTRUCT THE LOADER Td ENTER THE 
ee NAME INTS ITS SYMBAL TABLE AS LABELED CG@MNGN | 
REGI GN OR SYMREF’ S. SIZE IS GIVEN IF THE VARIASLE IS 
TG BE USED AS A LABELED C@MMGN -REGIGN AND REPRESENTS THE 

A 


AMSUNT OF STARAGE TS BE SET ASIDE AT THAT PSINT OF LOADIN 
“EF SIZE IS N&T GIVEN NAME.IS CONSIDERED AS A SYMREF, IF 
SIZE IS -TERMINATED BY THE CHARACTER L CI.E. /200L/), THE 
LABELED CAMM@N REGIGN NAME IS HANDLED AS -IF UNDER THE L@C@MN 


SPTIGN. ALL BTHER LABELED CSMHON REGIGNS ARE HANDLED 
TORMALLY.. 


TODS be 


700 CANTI NUED IN 


555  -. " THIS PERMITS LACATIANS OF NEW SYNDEF'S T®-3R DEFINED 3Y 

560 ° SY DEF S PREVIGUSLY DEFINED, DEFINING NEY SYHDEF'S .— 

585 RELATIVE T@ PREVIGUSLY DEFINED eer S, AND EQUATING 

570 LABELED COMMGN REGIS. RELATIVE TS BLANK CaMMAN, © | 

575 «DIFFERENT FQUATES RE SEPARATED BY cca, 

EO , 

\85 |= sOEX1 ROUATE NAMEL/NAMES, NAMES /, NANE 4/NAD 1E5/ 
30°. EX2 -FQUATE NAMECIO)/NANFD7. 

595.  EX3 EQUATE .CMN./LCL/,.CMN. C100) /LC2/ | 

600 - | Mey EE cans os oS, a. ce, ae 

605 FX1 DEFINES NAME? AND NAMES AS SYMDEF'S WITH THE EQUIVALEN 
CVO | LOCATIAN GF NAME, & FATAL ERR@R RESULTS IF NAMEL IS 

615 HNDRFINED,. IF NANE2 @P NAMFS HAVE BREN PREVISUSLY. 

62.0 DEFINED, THEY ARE REDEFINED, AND A NONFATAL ERROR 
625 MESSAG2 IS PRINTED, NAMES SYNDEF IS DEFINED AS HAVING 
“630 LaCATIAN EQUIVALENT T@ THAT OF NAMEA, 

635 | | 7 

640° IX2 A NEM SYMDEF NAY 3E DEFINED RELATIVE TO A PRE VIGUSLY 
645 -. DEFINED SYMDEF BY ENCLOSING THE INCREMENT IN PAREN- 

650 THESE ES. NAMED IS DEFINED AS THE LOCATION NAME+1O. 

$55.52. ues os 
660. -EX3. CHM. IS A STANDARD SYN3SL WHICH IS SyN@NYNSUS WITH 

665 ‘THE BEGINNING @F BLANK COMMON, -THE LASELED CaMuaN 
670 . REGIQNS (LC1 AND LC2) ARE EQUATED. TO THE RESPECTIVE 

675 POSITIONS GF BLANK COMNGN, “LABELED CSONMGN REGIGN 
680 - LC2 IS ASSIGNED AN ADDRESS roual TO THE SEGINNING. OF 

6B5 BLANK CGMMON PLUS 100 @CTAL. THE: LENGTH GF BLANK 

690. CAMM@N IS AD JUSTED ACCIRDINGLY. : , | 

ee | 


MLOAD2 


LIS 


N. 


MLOA D2 14:06 JUNE 22,1966 

QO 6/20/66 (RPL) 

100° MOLD IDADER (CONTINUED). 

105 - 

11.0 . 

‘115 10% HEM ORY PUsI Tid 

120.. 3 anes 

125 : NORMAL IGADING PROCEDURE WILL BE. HE WY LéaD SPTIZN 

150 DESCRIBED IN THE GEL@&D A@NUAL» IN BRODER Té-S&VE SPACE. 
135 FER BLANK COMM@N IT IS NECESSARY BW TELL THE LOADER. 

140 HOW FAR ABOVE THE BASE ADDRESS IT SHOULD PLACE THE. 

145 FIRST PROGRAM ae Lo 

150 a fae : re er 

155 COMMON N CAUSES THE IGADER T2 SKIP N LOCATIZNS BEFZRE 
160. | pi eet ‘IZADING THE FIRST PR&SGRAM. 

165 — et 

170 © HLBAD WILL CAUSE PROGRAMS TW 3E LSADED STARTING AT THE 
TTS. _ UPPER END OF ALLOCATED. aEMGRY. | 
180 ; . Soe ' 

185. 11. LIBRARY USE 

190. od eg Hs - 

195 THE USER IS ALL@WED TW SPECIFY CERTAIN FILES. WHICH 
| 200 CONTAIN LIBRARY. SUBRSUTINES. IF ALL JF THE SYMREFS “HAVE 
20.5 N@T BEEN DEFINED AT ‘HE END QF LSADING THE USERS. PREGRAMS 
210 THE LWADER WILL SEARCH HE LIBRARY FILES THE USER SPECIFIES > 
215 SEARCHING FOR SUBROUTINES THAT HAVE "PRIMARY SYMDEF SYiBgLS 
220 IDENTICAL TG ANY OF THE UNDEFINED SYHREF,. SYMBSZLS IN ITS 
225 SYMBOL TABLE. THE FILES WILL BE SEARCHED IN THE @RDER GIVE 
2350 , 

235 up MI P15 e005 80,PN 

240 

245. ME N'S ARE NAMES AND EOP TS. ARE PASSWORDS . 

250 

255 12. ENTRY LOCATIONS 

260 | et ad , 

265 CENTER. NAME SYMDEF ° NAME IS HE‘DESIRED ENTRY POINT Tey THE 
270 'PREGRAM. IF THIS @PTIZN IS N@T PRESENT ENTRY 
O15: IS MADE AT WHE FIRST CfFINED PRIMARY SY ADEF 
280 _. @F THE FIRST PROGRAA. IBADED. , 

285 . : | | ° - 
286 START C@NTR@L WILL BE TRANSFERED TW HE PROGRAM JUST L@ADED 
287 — (SEE ENTRY IBACATIG@N @PTIONS). | 7 
286 - . 

290 DUMP XXX ,PPP 

295. ) 

300 THIS COMMAND WILL DUMP A CORE IMAGE OF A PROGRAM THE USER 
505 HAS JUST IZADED AND PLACE IT IN FILE XXX. FILE XXX -MUST 
) 310 NOT ALREADY EXIST. PPP IS A PASS! WORD ‘Td PUT SN THE 
» 820" FILEs an : 

330° 

340 EXIT 

350 : >, | | 

560 THIS COMMAND WILL CAUSE THE LOADER TB EXIT BACK Td THE 
370. Lae < 


EXECUTIVE. 
380 iS a" 


LIST 


MICH AP - 3099] JULY 1, 1968 


mesle) MILD CHARACTER SET 
110: 

12.0 + 4 sa 
tee~* ~~ g MALD. CHARACTER SET 
BQ. | ene a 
200 . O00 . NULL 

210 COT ee ae ; 

cea = Oe 

ean  , O08 

240 O04 . . EST. 

moOe, O95 ENQ 

260 096 ACK © 


270 007 oe 
2RO | O10. RS | 


200 OF. 2402 
O1).0: O12 | LF 


31d. OLS) VT 
320 Ola + FF 
Sa? &. O15. “OCR 


540 01S Sh 
S50° . “OE? SI 
360 020. ~ DLE 
370 ~=a21 DC 1. 
380 022. BCe2 
490 025" DEG. 
400 024 DC4 
440 025. = =NAK- 
42.9 026 

430 027° = 
449  *OSO? “oe “CA 
LAO O31) ° 

455 032 _ 8 
460. O35. 22 “ESC 
470 034. 
480: 035 
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RIGHT PRACE | 
~YFRTICAL LINE 
- DELETE “242 ° 


(S230 SUE 30, 1966 
JUNE 27, "66 CKMLD . 
MISCELLANESLS " SYSTEM CONVENTIONS ~ 


FILE NAMES 


ome 
oo 
DQ 


AS -FAR AS THE EXECU 


EXECUTIVE IS C@NCERNED FILE AMES AR 
COMPASED GF 2 SS-RIT WERDS WHICH MAY HAVE ANY PATT 
OF O'S AND £'S, BUT EDITOR, DDT, GMAP, AND 
THE LOADER WILL BE WORKING PRIMARILY WITH ASC II 
S% THE FSLLEWING CONVENTION WILL-BE ADHERED T# BY 


POSE a SYo Leos 


NAMES WILL BE 8 CHA RACTERS ONG. IF -THE SAME SUPP 
A LESS -THAN § CHARACTERS A sUM! r 

ANKS WILL BE ADDED (@N..THE-RIGHT) TS 4 
STRING as CHARA \CTERS M Pee eer 
NAMES WILL Re LEFT JUSTIFIED AND £ 


‘. 


PLANK FILLED. 
ALSS THE NAME MUST NOT HAVE LEADING FLANKS OR 
ANE -GF THE FOLLOWING CHARACTERS IMBEDDED IN THE 
MA [rife ¢ sats ; cS ke AR. sa : 


PASSWORDS 


ge VERS EOS OF 


Ii! THE INIT WALD, ARDS WILe 

BE ALL@TTED GNLY 18 BITS SUT EDITSR, DDI | 

ETC, WILL &LL¢ Ww UP TG &S CHARACTERS. £4 Same MAPPING 
.MUST BE APPLIED T@ THE 8 CHARACTERS T® PR@DUCE THE 
PASSWSRD, THE FALLGWING MAPPING WILL RE USED: 
ASSUMING THE PASSWORD IS -COMPSSED GF THE 3: CHARACTE 
Cis Cly--< C8 THEN TRE ALGSRITHM IS 

CO COC CEE LHBECE Deter ( 03 kN CAM CADE CORN De. FOR) 
“WHERE M IS EQUAL TO 631463 PASE Gy IM CRDER 

A GET AN 18 BIT RESULT USE THE Lew ARDER 1S 

ITS OF THE RESULT. | | 

FONG PASSHSED IS SUPPLIED THEN, THE. VALUE O IS 
SUPPLIED AUTSMATICALLY, RY EVERY SYSTEM 
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eed a, 
waA 


As 


Ora : 
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ug 
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yp co bd 2 
SAAN S 


DNNDADAADDA= 


CHARACTER FILES 


TELETYPE 1 


PANIC 


HAVE 


OF GNE LEVEL UPWARD IM 


T 
ae Bt 


“BINGE IRE Se ALLLoT Ulli Tie ibe oye tee: 2S ee PAR 
HANDLING IS A WARD, ALL CHARACTER FILES i 
7y 


AxN CHARACTERS. 
USED 


THE FILE CHARACTER 


WEEN WRITING BH WORDS 


a BE 


rey ¢ TC 
ara aie ioe 


1 LINE RY LINE (ona HVEPSAT IAAL 
2 FILE PUILDINGCTYS CARRIAGE RETURNS 
IN A RGW CAUSES A RETURN TG LINE BY 
| COUVERSATIGNAL. 
EVENTUALLY SYSTEMS WILL SE ABLE Te SELE INPUT 
GEY Age. EXECU EVE “EXECUTIVE CALL. BUSS TUALLY 
THERE WILL BE AL SPECIAL READ COMMAND WHICH WELL 
RE USED FAR UNSCLICITED INPUT. UNSSLICITER | 
TNPUT IS DEFIMED AS ANY IMPUT-LINECA" LINES) wy 
COMES IM WHEN NG PRAD CAMBMAHD IS SUTSTAHDISG Fe 
THE PIELER ENSTE DEVICES Tue UNG IClr sD) ANPuy 
WILL BE GIVEN To TILE FIRST. PROGRAM IN THE 
SPAWN TREE WITH A SPECIAL READ GUTSTANDING, 
WILL ALL&U THE PRO&GRAM T@ BE INTERUPTED 


T IN A NAVE 
eECSPA yer 

HIS MEANS: 

RETU ae 


THE BREAK CHARACTER WILL ALWAYS) RES 
THE SPAWN TR 
MOVEMENT DGWN.A LEVEL). N@RMALLY T 
CURRENT J&B IS ABORTED AND THE EXECUTIVE 
CANTROL TA THE ANCESTSRAL JOE. 


. 


LE GF 


Eva Sl 


; 
CONSIST GF 4% CHARAC NG. THERE ARE 1 WARDS 
IN THE FILE), THERE IS, H0. END OF FILE CHARACTER 3X 
THE SYSTEMS LEVEL. THEREFSRE CHARACTER FILES MUST 
BE AUGMENTED T3 A MULTIPLE SF 4 CHARACTERS. THE . 
DELETE CHARACTERCSCTAL 177) SHULD: SE USED AS THE FILL 
HARACTER WHEN THE FILE DAES MOT TURM GUT Ta HAVE EXACTLY 
i= . ey 
mw OA DEN, ae 


E 


ae 


re) 


“a 


OLD PR@aBLEN NANE=-FAULTV 


READY. 


Lier 


FAULT | "13315 : JUNE, 30, 1966 


100. Jun 27, 1966 cL) 
poe 
129 


Lees 
199. - 1, SET THE PAR TS THE MAXIMUM ALLAWAPLE LIMIT 
200 °.-2@, EXECUTE THE FOLLAWING INSTRUCTIONS. BR THE 
219 STCL axI+k cil 
O20 Gea e Se QkI+1+2 ° WHER E 0, 2t<18 IS: THE NUMBER ASS 
240 : THe PAUL WHICH SOCURRED AND SCS The ASOT Ee 


232 “GF SLAVE ADDRESS On 


240 


280 FAULT ROUTINE CAN RETURN Ta THE PSINT GF INTE 
290 EXECUTING A RET 2x1, aes 


“300 


310 WARNING 
320) 


S608. 36 IF THE SAME FAULT @CCURS IN THE FAULT HANDLING 
340 -  Y@U WILL NOT BE ABLE Ta RETURN T9 THE @RIGINAL P@IN 
“550% OF INTERUPTIGN UNLESS THE. is STRUCTIGN CSUNTER (CONTE 


3560. —  LACATISN 2kI) HAS BEEH PUSHE D GNTS A STACK. 


3.70 
380. 
390 


- 400 NOTE THAT FAULT 0 IS USED Fa 
ALO. © - THAT IS THE EXECUTIVE WILL: 


le 23 5 
me 


420° — . ONE WHEN STARTING UP A Je CA 


422 6 | — SPAWN C@MMAND. 


430 


Torte 
BILETY 


140 RACH SLAVE PRAGRAN TS.BE RUM IN THE H@LDY BHVIREAMENT , 
“150° MUST DEDICATE 32-WARBS CLOCATIONS 0-31) -TE A FAUL, VEGTER 
‘170 IF A FAULT GCCIRS WHICH. IS THE SLAVE PRaGRANS RESPANS 

180 THEN THE EXECUTIVE WILL CARRY SUT THE FSLLAWING? 


270 IF THE Jap Is NAT USING THE CONTRAL PRAGRAM GSPTISN THEN TUE. 
| 
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310° 
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WILL. NEVE 
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CANTREAL 


PR 
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RADA a0 
Tie 


Me THIS IS 
LAYER L 
LOWEST 
Je 


FAULT: TAG. 


Cana AND FAULT 


DIVIDE CHECK - 


EXECUTE 


BLY. 
E. PROGRAM. 


ER BE USED EXECPT AS. 


TARTUP 
J&B- WHEN THE. EXECUTIV TRANSFER 


TS LACATIAN 1. 


AN. ILLEGAL ADDRESS HAS BREEN - 


RETURNED TO THE USER PROGRAR IF THE 
IMIT @F THE BAR IS NST EQUAL TA THE 
DROER REMRY LeCATiGny feo leer). Tio gk 
THAT IS THE.CONTRAL GPTIvd ALLAWS 
TRAL PROGRAR TA PRE-EMPT MNE’S, 
ULT SCCURS WHEN FHE PSEUDS KER 

= is 


TRY MAY. EVENTUALLY PE. USED Ta ~ 
= THAT A RENSTE CONSGLECFILE) HAS 
A COMM : 


Structure of the fob stack 

At the bottom of the stack is fixed format infomnation that never varies from’, 

job to job. This contains the account number for billing and pointers used 
to reference file buffers and pointers It also contains the. saved instruction | 
counter plus indicators and the saved x ventacarss | This is where the registers 
fd Sere Neon are always saved whenever the program is not currently being executed. 
On top od the fixed locations are the buffers used by the file system. These . - 
‘are of variable length so the area must be alloca ‘ted dymamically. “In the first | 
implementation the buffers will, all be the same size (the maximum) to simplify the 
design of the file systen. There will also be information as to device ae | 
amount of buffer filled, link information, and interrupt location, and dat | . 
control word storage o Tf a user calls the exec with a. file call that ere oreeed. 
-the limits of his state vector, he is scineabehtaes ea pped out with the Ic decremented 
by one. and the state vector incremented by 1/2 K. | When he is swapped back in, 

the }ME will-then be executed again and the file call will then be processed. 

ALL of this operation is hidden from the user. Memory alYocation is done by. 
tie LEV. ial scheme of assigning the next available memory to the next’ prog ram. 

hen this runs out: of memory because the next program won?t fit, the algorithm 
MELE until the. lowest portion of memory is free and the process starts over 
 acain. The scheduling algorithm is.done by reference to 2 tables, the run flag 
table and the priority table. One pass is made through the two tables every 
‘quantum. end the tables are updated. The program with the highest prdority 

that is ready to run is run. ‘If there is no program ready to run, the. system 

waits until one is ready. The scheduling.algovithm operates on the principle 

that Lh lhete.- sre m-uscss;. each user LS entities oO 2/n th of the available . 
machine time. Therefore, a user who does a@ lot of real time input with very 

; 
Fe 


little calculating will get fast response time white a user who requires a great 
deal of machin me Will not delay the system for the other users but will still 
e-computer. The algorithm is designed so that the priority 
Ses exponent tially to one when the program is not being run 
entially to zero when it is being run. Therefore, the _ 

i past usage of the computer by the 


priority represents a weighted average of the 
n £ program priority by the scheduling 


prograa and can be used as an indication o 
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Exceutive functions . ; 

the executive is the section of code that is permanently in core and performs 
“unetians such as scheduling and memory allocation. ‘These functions that enable 
tine sharing to Funct ion ara invisible to the user program and the user can write 
nis routines with the assumption that he is the only one using the machine O£ 
course, the user must adhere to certain conventions or he cannot take Full “advantage 
of the system.. All I/0 must be done through the file system. No £T/O can refer 

fic device or use a specific device address. . ‘he avallable calls on 

stem are given on another page. Cther calls are: . 


TIME gives the running time’in 15.625 usec’ intervals 
CLOCK Gives the time of day in the 0 in edited BUd format 


on only when. the condition 
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| ao we ol 
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See oR S causes the BAR to be set inside the user program [used for debugging | 
SET TLR (causes a timer runout Zault at the end of the given execution time 
Sei causes the execution On spavn med proces 

PS 


Se communication between 
ratLons . a File can als 

o the other process? 

fered to ae Spawne] process to use 


processes is by interrupts an 

Set Up so a write or a rea 
opened files can also be tran 
=s own. 


io) A Bes 
ry 
it 


PAR ORITT ATS “V4 


TERMINATE causes immediate termination of the process and the ineremental 
dumping of files closed[? land the reassignment of special files 


[selotynes 


user sets the base address register to a value that docs not 
ations, he immediately gets control of any Fault with the base 
t to the original value and he @iso gets control of ME faults. 
Sible for Bee program to get out of contro] by making calls on 
only faults thet the user cannot nomaelly get control of are: 
nh, connect, parity, Sees execute. it is to be noticed that the u 
Lgnore interrupts with a RET *-1 because the stored IC is with peas 
ox pase address. ‘fhe SET BA call gives the user oe option of trans 
lave location with any machine registers and indicators. Tnus a co 
estarted. This, feature is mainly used with deabu canine The master £ 
y is keep in memofy at all times in [read only storage } with a copy on 
random access storage devices. Areas used in swapping are in the master file 
£0 7 mize the time to find 2 swap address. A11 other dotalass. are on 
se. ALL catalogs with high anticipated usage are duplicated to 
Le a teletype connected to a user program dissappears, 
ted to the user program and all programs related to it. 
he teletype use could be billed must terminate in a short 
ve themselves for restart) or they will be aborted by the 
is . prevent accidental clearing out of a teletype from running 
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Format of a catalog 


Each catalog entry contains the following information: 


l name of file or catalog 

2 restriction bits eu permit, temporary cre. GtC o oteine or ca éntoe] 
3 nave of trap file or password 7 7 
4 date of last modification (or epoeenen ent ee ‘tape Ranbeesee es 
5 statistical seaedntion (usage ¢ £4) 

G device address 


es 


Links have a different format but nee they will not be implemented, soon no 


detailed format 


t that will prevent the coded face and statistical information from 


There is a bit : 
being. updated so that often used catalogs will not have to constantly be rewritten 


ye os ea Bt a 


“baek onto ‘drum or disk. This bit cannot be set by the system? but is in 
Ft-n used 


at 
the 
placed on the master file directory and all other directories CRASS Ara O 
-and never du unped beeanse of inactivity. 


rh 


Status returns of the File system 


Unless the call to the File system is in esror (wrong format ete.) the 
file system will return immediately without any infon MACLON except that the 


call was accepted, When the file system completes its task, it will interrupt 
the user prosram. he status returns of the completed operation cannot be 
transmitted through the registers because thev will contain the users. . 
Tegisters at the time of the interrupt. ‘The status returns cannot be stcred. 

im a stendard location because of the possibility of simultaneous interrupts. 

the File system will therafore store the status retin of the com ipleted operation 
by reference to a standard pointer word. The file system will store the ‘status 


word. ~It will then 
ieation.. ‘thus the status 
fied in the pointer is | 


@ 
return in the slave location specified by the Eee 
refor to the poi 1ter word with a NOP with an AD modi. 


returns will be stored in a list. I£ the deita speci 
zero, no inerementing will take place and all: status returns will be stored in 
the same location. The user prograia can either sean the table for the new 
status returns oF he can, at the start of each interrupt routine, pick = the 
status retumms with an SD modification. © if the user rey eave Stkecrscteys 
sii kadar dayd [rowed ind added pad Podane [ke die sea cuks fratdta | [itd will always 
piek up the status return that caused the Llaterrunt vhink about this for 
awhile to be convinced that this is true. It is based mainly. on the fact that 
the last interrupt to take place is the first cone inigieted « Interrupts do not 
have to be inhibited before the Status return is loaded. ‘t is not known yet 
whether the status return will take up one word or two but user programs should 
‘assume two status returns words. ‘These statuses will inform the user whether any 


unusual conditions were detected on the previous command. Tt will also contain 
the information as to the number of words read if the operation was temainated by 
an enc of record or an end of file. Example of a file copying. routine: 
‘11 files are assumed to be opens 
.This routine copies file 1 into 
Error Géetection and end of file i 


Pile 1 interrupt routine: GUc.escver 
| TRA = = 
intl: 7SREG regi 
LN4A40 status, £9 


Tit  endchk 
WKLTE 2512,m,7 i2 is the 2nd interrupt location 


. . 4 , a anenee att tee 
File 2 interrupt routine: “Tt eam: 


TRA int2 
int2: SREG reg2 
LDAQ- status,SD 
TMS check 
READ 1,1i1,m)n 
LREG reg2 


RET  i2 


additional effort. 


This interrupt routine could be puffered with little a 

Notice? that the status return is loaded once as a part of both interrupt 

routines. In this example only one file operation is in progress at any 

given instant but the presence of other file. activities would not affect the 
operation of these 2 routines. Even with the sin Eee mGous operation of several 
file operations, it is unnecessary (and usless) to set the inhibit bit on in 

the interrupt routines. Siveral interrupts ee ee simuitancously and 

the user must exit the interrupt routine normally (RET) of interrupts will be lost. 


Tranvine the user and status returms 


aaa 


ams. currently 
n a. standard place. 
trap a user 


“henever the 1/0 interrupt routine is being executed, ail pro 
in memory have ail of their registers and indicators stored 
in tha progzra m header. waren the T/O interrunt routine wan 
program, it iia the saved instruction counter and indica 


ce for the progra 
and stores it in the location trap. it then stores the loca 
7 


tion of trapl in 
is that when the - 
on 


the saved instruction counter location. The affect of this 
pace cogram is resto: ed it will execute the instruction in location trapth with all 
dicators and registers unchanged, The program ean ignore the interr rupt Dy. 
aciae: a RET *-1 in tran+1. Under no cirecunastances should a.user specify the’ 


Coreen ee 


same trap location for more than one operation. If he does, there is a ee 


that the program may never leave the interrupt routine as several simulated traps 
may occur at the same tine. YE two Taps oceur at nea ely | the same time, the 
sacond user interru pe poue ENE will be excented first. ° The word that is. stored 
‘fn location trap contains the instruction counter and the indicators. it aise. 
eostedng in Bees 25 ise Uanine Bienes mses ape a lonesome The | 


possibla returns 


Hi 075) 
Abe eH We TN le cer “ 


formal -. no unusual conditions, operation successfu 11kv completed 

nae ‘acord ~ an end of record was detected on the last operation. © must issue 
another read command to continue reading the file. : 

End of file - an end-of file was detected on. the. 

irror = unreecvarable arror an attompt will be made to restore the. File from 


ra 
hh oct 


the dump tape but you vege for now 
Eratection violation - incorrect password or prive eleged comnand 
Pile not open - operation recuires file specified to be open for read/write etc. 
Duplicate name ~ attempt to create two files of the sane name 
On a read, the user should wait to be interrupted before attempting to use 
anv of the data read ins On a write, the user must not change the data until 
he has been interrupted. a copy command can be stopped at any time [se ehow]}. 
* user should never execute a DIS instruction. If he must wait for the completion 
of a file operation he should execute a call ee UNTIL CONDITION" and ‘spe cify 


the conditions that must 


rx t . 
be met before be bine continuing. The Format of this cal 
are unknown but suggese S 


ons are welcome. 


be 


Pile System Calis 
OPEN FOR RESPING i, trap, name, password 
Search catalog 


For name end-'ve rify password if any. When complete, trap user 
to location traj ar 


OPEN POR APPENDING i, trap, name, password . 


Search catalog 


i for name.and verify password if any. When, ecmplete, trap user 
to location tra PD 


es ee se : fe) . 

Read the next n words into memory location m/a 1d trap user to location trap when done. 

Aye ht TT eng 

RESTORE Usp 
/ a 


WRITE i, trap, m,n 


Append: the n next n words from memory location m to File i and trap user to location 
™ . 2 : : © . ‘ . 


2 a sp . —, . oe 
trap when done. 


Close file i then trap user to location trap. 


CREATE .1, trap, name, restrict Lons 


Create an entry of nane in catalog £ with restr ietions. Open the file for. writing 
and trap user to location Erp o 

DESTROY i,trap, name, pas sword 

‘Delete name in seuss i if password is correct. Then trap user to location trap. 
CHANGE L, trap, mame, password, newname, restrictions 

Search. catalo iL foe name and verify password if any. Then change name to newnane 


a £ 
and replace old restrictions by vestrictions. 


Copy Be > jon, trap 


Copy file i into file j but not more than n words » Then trap user to location trap. 

This command is designed for use with teletypes by allowing the teletypes to input 

directly into a file without explicit read and write commands. It will tesminate 
an end of record or end of Fille. 
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